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This invention relates to software and to development of such software. 
More particularly, this invention relates to a programming interface that facilitates 
use of a software platform by application programs and computer hardware. 

BRIEF DESCRIPTION OF ACCOMPANYING COMPACT DISCS 

Accompanying this specification is a set of three compact discs that stores a 
Software Development Kit (SDK) for the Microsoft® Windows® Code-Named 
"Longhorn" operating system. The SDK contains documentation for the 
Microsoft® Windows® Code-Named "Longhorn" operating system. Duplicate 
copies of each of these three compact discs also accompany this specification. 

The first compact disc in the set of three compact discs (CD 1 of 3) 
includes a file folder named “lhsdk” that was created on October 22, 2003; it is 
586 Mbytes in size, contains 9,692 sub-folders, and contains 44,292 sub-files. The 
second compact disc in the set of three compact discs (CD 2 of 3) includes a file 
folder named “ns” that was created on October 22, 2003; it is 605 Mbytes in size, 
contains 12,628 sub-folders, and contains 44,934 sub-files. The third compact disc 
in the set of three compact discs (CD 3 of 3) includes a file folder named “ns” that 
was created on October 22, 2003; it is 575 Mbytes in size, contains 9,881 sub- 
folders, and contains 43,630 sub-files. The files on each of these three compact 
discs can be executed on a Windows®-based computing device (e.g., IBM-PC, or 
equivalent) that executes a Windows®-brand operating system (e.g., Windows® 
NT, Windows® 98, Windows® 2000, Windows® XP, etc.). The files on each 
compact disc in this set of three compact discs are hereby incorporated by 
reference. 
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Each compact disc in the set of three compact discs itself is a CD-R, and 
conforms to the ISO 9660 standard. The contents of each compact disc in the set 
of three compact discs is in compliance with the American Standard Code for 
Information Interchange (ASCII). 

BACKGROUND 

Very early on, computer software came to be categorized as “operating 
system” software or “application” software. Broadly speaking, an application is 
software meant to perform a specific task for the computer user such as solving a 
mathematical equation or supporting word processing. The operating system is 
the software that manages and controls the computer hardware. The goal of the 
operating system is to make the computer resources available to the application 
programmer while at the same time, hiding the complexity necessary to actually 
control the hardware. 

The operating system makes the resources available via functions that are 
collectively known as the Application Program Interface or API. The term API is 
also used in reference to a single one of these functions. The functions are often 
grouped in terms of what resource or service they provide to the application 
programmer. Application software requests resources by calling individual API 
functions. API functions also serve as the means by which messages and 
information provided by the operating system are relayed back to the application 
software. 

In addition to changes in hardware, another factor driving the evolution of 
operating system software has been the desire to simplify and speed application 
software development. Application software development can be a daunting task, 
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sometimes requiring years of developer time to create a sophisticated program 
with millions of lines of code. For a popular operating system such as various 
versions of the Microsoft Windows® operating system, application software 
developers write thousands of different applications each year that utilize the 
operating system. A coherent and usable operating system base is required to 
support so many diverse application developers. 

Often, development of application software can be made simpler by making 
the operating system more complex. That is, if a function may be useful to several 
different application programs, it may be better to write it once for inclusion in the 
operating system, than requiring dozens of software developers to write it dozens 
of times for inclusion in dozens of different applications. In this manner, if the 
operating system supports a wide range of common functionality required by a 
number of applications, significant savings in applications software development 
costs and time can be achieved. 

Regardless of where the line between operating system and application 
software is drawn, it is clear that for a useful operating system, the API between 
the operating system and the computer hardware and application software is as 
important as efficient internal operation of the operating system itself. 

Furthermore, most applications make use of data. This data can oftentimes 
change during execution of and/or the life of the application, and is typically 
stored on a local device or on some remote device (e.g., a file server or other 
computing device on a network). Traditionally, applications have “owned” their 
own data, with each application being responsible for managing its own data (e.g., 
retrieving, saving, relocating, etc.) using its own formats. This traditional 
structure has problems, however, as it makes searching for related data across 
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applications very difficult, if not impossible, and frequently results in similar 
information having to be entered in multiple places (for example, contact 
information may have to be entered separately into an email application, a 
messenger application, a phone application, a word processor, and so forth). 

The inventors have developed a unique set of programming interface 
functions to assist in solving these problems. 

SUMMARY 

A programming interface for a computer platform is described herein. 

In accordance with certain aspects, the programming interface can include 
one or more of the following groups of types or functions: those related to core 
file system concepts, those related to entities that a human being can contact, those 
related to documents, those common to multiple kinds of media, those specific to 
audio media, those specific to video media, those specific to image media, those 
specific to electronic mail messages, and those related to identifying particular 
locations. 

BRIEF DESCRIPTION OF THE DRAWINGS 

The same numbers are used throughout the drawings to reference like 
features. 

Fig. 1 illustrates a network architecture in which clients access Web 
services over the Internet using conventional protocols. 

Fig. 2 is a block diagram of a software architecture for a network platform, 
which includes an application program interface (API). 
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Fig. 3 is a block diagram of unique namespaces supported by the API, as 
well as function classes of the various API functions. 

Fig. 4 is a block diagram of an example of the logical structure of 
namespaces. 

Fig. 5 is a block diagram of an exemplary computer that may execute all or 
part of the software architecture. 

Figs. 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, and 17 illustrate various example 
implementations of a programming interface. 

DETAILED DESCRIPTION 

This disclosure addresses programming interfaces such as an application 
program interface (API) for a network platform upon which developers can build 
Web applications and services. More particularly, an exemplary API is described 
for operating systems that make use of a network platform, such as the .NET™ 
Framework created by Microsoft Corporation. The .NET™ Framework is a 
software platform for Web services and Web applications implemented in the 
distributed computing environment. It represents the next generation of Internet 
computing, using open communication standards to communicate among loosely 
coupled Web services that are collaborating to perform a particular task. 

In the described implementation, the network platform utilizes XML 
(extensible markup language), an open standard for describing data. XML is 
managed by the World Wide Web Consortium (W3C). XML is used for defining 
data elements on a Web page and business-to-business documents. XML uses a 
similar tag structure as HTML; however, whereas HTML defines how elements 
are displayed, XML defines what those elements contain. HTML uses predefined 
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tags, but XML allows tags to be defined by the developer of the page. Thus, 
virtually any data items can be identified, allowing Web pages to function like 
database records. Through the use of XML and other open protocols, such as 
Simple Object Access Protocol (SOAP), the network platform allows integration 
of a wide range of services that can be tailored to the needs of the user. Although 
the embodiments described herein are described in conjunction with XML and 
other open standards, such are not required for the operation of the claimed 
invention. Other equally viable technologies will suffice to implement the 
inventions described herein. 

As used herein, the phrase application program interface or API includes 
traditional interfaces that employ method or function calls, as well as remote calls 
(e.g., a proxy, stub relationship) and SOAP/XML invocations. 

Exemplary Network Environment 

Fig. 1 shows a network environment 100 in which a network platform, such 
as the .NET™ Framework, may be implemented. The network environment 100 
includes representative Web services 102(1), ..., 102(N), which provide services 
that can be accessed over a network 104 (e.g., Internet). The Web services, 
referenced generally as number 102, are programmable application components 
that are reusable and interact programmatically over the network 104, typically 
through industry standard Web protocols, such as XML, SOAP, WAP (wireless 
application protocol), HTTP (hypertext transport protocol), and SMTP (simple 
mail transfer protocol) although other means of interacting with the Web services 
over the network may also be used, such as Remote Procedure Call (RPC) or 
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object broker type technology. A Web service can be self-describing and is often 
defined in terms of formats and ordering of messages. 

Web services 102 are accessible directly by other services (as represented 
by communication link 106) or a software application, such as Web application 
1 10 (as represented by communication links 1 12 and 1 14). Each Web service 102 
is illustrated as including one or more servers that execute software to handle 
requests for particular services. Such services often maintain databases that store 
information to be served back to requesters. Web services may be configured to 
perform any one of a variety of different services. Examples of Web services 
include login verification, notification, database storage, stock quoting, location 
directories, mapping, music, electronic wallet, calendar/scheduler, telephone 
listings, news and information, games, ticketing, and so on. The Web services can 
be combined with each other and with other applications to build intelligent 
interactive experiences. 

The network environment 100 also includes representative client devices 
120(1), 120(2), 120(3), 120(4), ..., 120(M) that utilize the Web services 102 (as 
represented by communication link 122) and/or the Web application 110 (as 
represented by communication links 124, 126, and 128). The clients may 
communicate with one another using standard protocols as well, as represented by 
an exemplary XML link 130 between clients 120(3) and 120(4). 

The client devices, referenced generally as number 120, can be 
implemented many different ways. Examples of possible client implementations 
include, without limitation, portable computers, stationary computers, tablet PCs, 
televisions/set-top boxes, wireless communication devices, personal digital 
assistants, gaming consoles, printers, photocopiers, and other smart devices. 
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The Web application 110 is an application designed to run on the network 
platform and may utilize the Web services 102 when handling and servicing 
requests from clients 120. The Web application 1 10 is composed of one or more 
software applications 130 that run atop a programming framework 132, which are 
executing on one or more servers 134 or other computer systems. Note that a 
portion of Web application 1 10 may actually reside on one or more of clients 120. 
Alternatively, Web application 110 may coordinate with other software on clients 
120 to actually accomplish its tasks. 

The programming framework 132 is the structure that supports the 
applications and services developed by application developers. It permits multi- 
language development and seamless integration by supporting multiple languages. 
It supports open protocols, such as SOAP, and encapsulates the underlying 
operating system and object model services. The framework provides a robust and 
secure execution environment for the multiple programming languages and offers 
secure, integrated class libraries. 

The framework 132 is a multi-tiered architecture that includes an 
application program interface (API) layer 142, a common language runtime (CLR) 
layer 144, and an operating system/services layer 146. This layered architecture 
allows updates and modifications to various layers without impacting other 
portions of the framework. A common language specification (CLS) 140 allows 
designers of various languages to write code that is able to access underlying 
library functionality. The specification 140 functions as a contract between 
language designers and library designers that can be used to promote language 
interoperability. By adhering to the CLS, libraries written in one language can be 
directly accessible to code modules written in other languages to achieve seamless 
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integration between code modules written in one language and code modules 
written in another language. One exemplary detailed implementation of a CLS is 
described in an ECMA standard created by participants in ECMA TC39/TG3. 
The reader is directed to the ECMA web site at www.ecma.ch. 

The API layer 142 presents groups of functions that the applications 130 
can call to access the resources and services provided by layer 146. By exposing 
the API functions for a network platform, application developers can create Web 
applications for distributed computing systems that make full use of the network 
resources and other Web services, without needing to understand the complex 
interworkings of how those network resources actually operate or are made 
available. Moreover, the Web applications can be written in any number of 
programming languages, and translated into an intermediate language supported 
by the common language runtime 144 and included as part of the common 
language specification 140. In this way, the API layer 142 can provide methods 
for a wide and diverse variety of applications. 

Additionally, the framework 132 can be configured to support API calls 
placed by remote applications executing remotely from the servers 134 that host 
the framework. Representative applications 148(1) and 148(2) residing on clients 
120(3) and 120(M), respectively, can use the API functions by making calls 
directly, or indirectly, to the API layer 142 over the network 104. 

The framework can also be implemented at the client devices 120. Client 
120(3) represents the situation where a framework 150 is implemented at the 
client. This framework may be identical to server-based framework 132, or 
modified for client purposes. The framework 150 includes an API layer analogous 
to (or identical to) API layer 142 of framework 132. Alternatively, the client- 
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1 based framework may be condensed in the event that the client is a limited or 

2 dedicated function device, such as a cellular phone, personal digital assistant, 

3 handheld computer, or other communication/computing device. 

4 

5 DEVELOPERS’ PROGRAMMING FRAMEWORK 

6 Fig. 2 shows the programming framework 132 in more detail. The 

7 common language specification (CLS) layer 140 supports applications written in a 

8 variety of languages 130(1), 130(2), 130(3), 130(4), ..., 130(K). Such application 

9 languages include Visual Basic, C++, C#, COBOL, Jscript, Perl, Eiffel, Python, 

10 and so on. The common language specification 140 specifies a subset of features 

11 or mles about features that, if followed, allow the various languages to 

12 communicate. For example, some languages do not support a given type (e.g., an 

13 “int*” type) that might otherwise be supported by the common language runtime 

14 144. In this case, the common language specification 140 does not include the 
is type. On the other hand, types that are supported by all or most languages (e.g., 

16 the “int[]” type) is included in common language specification 140 so library 

17 developers are free to use it and are assured that the languages can handle it. This 
is ability to communicate results in seamless integration between code modules 

19 written in one language and code modules written in another language. Since 

20 different languages are particularly well suited to particular tasks, the seamless 

21 integration between languages allows a developer to select a particular language 

22 for a particular code module with the ability to use that code module with modules 

23 written in different languages. The common language runtime 144 allow seamless 

24 multi-language development, with cross language inheritance, and provide a 

25 robust and secure execution environment for the multiple programming languages. 
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For more information on the common language specification 140 and the common 
language runtime 144, the reader is directed to co-pending applications entitled 
“Method and System for Compiling Multiple Languages”, filed 6/21/2000 (serial 
number 09/598,105) and “Unified Data Type System and Method” filed 7/10/2000 
(serial number 09/613,289), which are incorporated by reference. 

The framework 132 encapsulates the operating system 146(1) (e.g., 
Windows®-brand operating systems) and object model services 146(2) (e.g.. 
Component Object Model (COM) or Distributed COM). The operating system 
146(1) provides conventional functions, such as file management, notification, 
event handling, user interfaces (e.g., windowing, menus, dialogs, etc.), security, 
authentication, verification, processes and threads, memory management, and so 
on. The object model services 146(2) provide interfacing with other objects to 
perform various tasks. Calls made to the API layer 142 are handed to the common 
language runtime layer 144 for local execution by the operating system 146(1) 
and/or object model services 146(2). 

The API 142 groups API functions into multiple namespaces. Namespaces 
essentially define a collection of classes, interfaces, delegates, enumerations, and 
structures, which are collectively called “types”, that provide a specific set of 
related functionality. A class represents managed heap allocated data that has 
reference assignment semantics. A delegate is an object oriented function pointer. 
An enumeration is a special kind of value type that represents named constants. A 
structure represents static allocated data that has value assignment semantics. An 
interface defines a contract that other types can implement. 

By using namespaces, a designer can organize a set of types into a 
hierarchical namespace. The designer is able to create multiple groups from the 
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set of types, with each group containing at least one type that exposes logically 
related functionality. In the exemplary implementation, the API 142 is organized 
to include three root namespaces. It should be noted that although only three root 
namespaces are illustrated in Fig. 2, additional root namespaces may also be 
included in API 142. The three root namespaces illustrated in API 142 are: a first 
namespace 200 for a presentation subsystem (which includes a namespace 202 for 
a user interface shell), a second namespace 204 for web services, and a third 
namespace 206 for a file system. Each group can then be assigned a name. For 
instance, types in the presentation subsystem namespace 200 can be assigned the 
name “Windows”, and types in the file system namespace 206 can be assigned 
names “Storage”. The named groups can be organized under a single “global 
root” namespace for system level APIs, such as an overall System namespace. By 
selecting and prefixing a top level identifier, the types in each group can be easily 
referenced by a hierarchical name that includes the selected top level identifier 
prefixed to the name of the group containing the type. For instance, types in the 
file system namespace 206 can be referenced using the hierarchical name 
“System. Storage”. In this way, the individual namespaces 200, 204, and 206 
become major branches off of the System namespace and can carry a designation 
where the individual namespaces are prefixed with a designator, such as a 
“System.” prefix. 

The presentation subsystem namespace 200 pertains to programming and 
content development. It supplies types that allow for the generation of 
applications, documents, media presentations and other content. For example, 
presentation subsystem namespace 200 provides a programming model that allows 
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1 developers to obtain services from the operating system 146(1) and/or object 

2 model services 146(2). 

3 The shell namespace 202 pertains to user interface functionality. It supplies 

4 types that allow developers to embed user interface functionality in their 

5 applications, and further allows developers to extend the user interface 

6 functionality. 

7 The web services namespace 204 pertains to an infrastructure for enabling 

8 creation of a wide variety of web applications, e.g. applications as simple as a chat 

9 application that operates between two peers on an intranet, and/or as complex as a 

10 scalable Web service for millions of users. The described infrastructure is 

11 advantageously highly variable in that one need only use those parts that are 

12 appropriate to the complexity of a particular solution. The infrastructure provides 

13 a foundation for building message-based applications of various scale and 

14 complexity. The infrastructure or framework provides APIs for basic messaging, 

is secure messaging, reliable messaging and transacted messaging. In the 

16 embodiment described below, the associated APIs have been factored into a 

n hierarchy of namespaces in a manner that has been carefully crafted to balance 

is utility, usability, extensibility and versionability. 

19 The file system namespace 206 pertains to storage. It supplies types that 

20 allow for information storage and retrieval. 

21 In addition to the framework 132, programming tools 220 are provided to 

22 assist the developer in building Web services and/or applications. One example of 

23 the programming tools 220 is Visual Studio™, a multi-language suite of 

24 programming tools offered by Microsoft Corporation. 

25 
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Fig. 3 shows the file system namespace 206 in more detail. In one 
embodiment, the namespaces are identified according to a hierarchical naming 
convention in which strings of names are concatenated with periods. For instance, 
the file system namespace 206 is identified by the root name “System.Storage”. 
Within the “System.Storage” namespace is another namespace for 
synchronization, identified as “System.Storage.Synchronization”. With this 
naming convention in mind, the following provides a general overview of the file 
system namespace 206, although other naming conventions could be used with 
equal effect. 

The file system namespace 206 (“System.Storage”), includes classes and 
APIs that support the file system. The file system, which may also be referred to 
as “WinFS”, is an active storage platform for organizing, searching for, and 
sharing all kinds of information. This platform defines a rich data model, builds 
on top of a relational storage engine, supports a flexible programming model, and 
provides a set of data services for monitoring, managing, and manipulating data. 
The data can be file-based or non-file data, and data is typically referred to as an 
“item”. The file system extends the functionality typically provided by file 
systems because it also deals with items that are non-file data, such as personal 
contacts, event calendars, and e-mail messages. Additional information regarding 
the file system can be found in U.S. Patent Application No. 10/646,545, filed 
8/21/03, entitled "Systems and Methods for Interfacing Application Programs with 
an Item-Based Storage Platform", which is hereby incorporated by reference. 

The file system namespace 206 defines additional namespaces, which may 
also be referred to as schemas. These additional namespaces include one or more 
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of: Synchronization namespace 302, Notification (or Notifications) namespace 
304, Meta namespace 306, Core namespace 308, Base namespace 310, Contact (or 
Contacts) namespace 312, Document (or Documents) namespace 314, Media 
namespace 316, Audio namespace 318, Video namespace 320, Image (or Images) 
namespace 322, Message (or Messages) namespace 324, Fax namespace 326, 
Email (or Mail) namespace 328, Annotation (or Annotations) namespace 330, 
Note (or Notes) namespace 332, Program (or Programs) namespace 334, Explorer 
namespace 336, NaturalUI (or NaturalUserlnterface) namespace 338, ShellTask 
(or ShellTasks) namespace 340, UserTask (or User Tasks) namespace 342, Help 
(or Assistance) namespace 344, Service (or Services) namespace 346, Location (or 
Locations) namespace 348, Principal (or Principals) namespace 350, Calendar (or 
Calendars) namespace 352, Watcher namespace 354, Interop namespace 356, File 
(or Files) namespace 358, GameLibrary (or GameLibraries) namespace 360, and 
CategoryHierarchy (or CategoryHierarchies) 362. 

The file system namespace 206 defines a data model for the file system. 
The file system namespace 206 describes the basic conceptual structure for 
defining other namespaces, which are described in more detail below. The file 
system namespace 206 includes, for example, definitions of items, relationships, 
nested elements, extensions, and so forth. 

The Synchronization namespace 302 (“System. Storage. Synchronization”) 
defines classes and interfaces that allows data and data changes to be moved 
between the WinFS file system and other file systems. The functionality defined 
by namespace 302 allows, for example, data stored in formats defined by previous 
(legacy) file systems, databases, and other data storage structures to be represented 
and manipulated in the WinFS file system, thereby making the data accessible to 
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the functionality of the other namespaces described herein. The functionality 
defined by namespace 302 further allows, for example, data stored in the WinFS 
file system to be represented and manipulated in other data storage structures or 
formats. 

The Notifications (or Notification) namespace 304 
(“System.Storage.Notifications” or “System.Storage.Notification”) defines classes 
and interfaces that allow for the creation and management of rules. The 
Notifications namespace 304 allows rules to be defined (e.g., by applications) as 
well as actions to take when data events (such as the addition, modification, or 
deletion of data) conforming to one of the mles is detected. The file system 
monitors these rules for data events that conform to the rules and takes the defined 
actions when such data events are detected. The file system may search through 
data that is stored in the file system to detect data that such an event has occurred, 
and/or analyze data as it is accessed (e.g., by the same application defining the rule 
or a different application) to detect whether operations on data conform to one or 
more of the rules. 

The Meta namespace 306 (“System. Storage. Meta”) is used to define other 
schemas in file system namespace 206 (also referred to as the other namespaces in 
file system namespace 206). The Meta namespace 306 defines the overall schema 
or namespace of these other namespaces in namespace 206 in a form that allows 
querying (e.g., to allow applications to see what types have been installed as part 
of the file system). New types can be created by authoring a schema document 
(e.g., in an XML (extensible Markup Language) format, other markup language 
format, or other non-markup language format) and installing that schema 
document as part of the file system. For example, in certain embodiments the 
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meta namespace 306 defines a type which may be called “type” and a type which 
may be called “property”, with a relationship between the “type” type and the 
“property” type that indicates which properties are found with which types. By 
way of another example, certain embodiments define a type which may be called 
“schema” in the meta namespace 306, with a relationship between the “type” type 
and the “schema” type that indicates which types appear in which schemas 
(namespaces). 

The Core namespace 308 (“System.Storage.Core”) defines types that are 
regarded as being the core concepts behind the WinFS file system. The Core 
namespace 308 represents the core concepts that the operating system itself is 
expected to understand, and that are expected to be used by most other sub- 
namespaces 302 - 362. For example, in certain embodiments the Core namespace 
308 defines the following seven types: message (an item that represents any of a 
variety of different kinds of messages, such as Email messages, fax messages, and 
so forth), document (an item that represents content that is authored), contact (an 
item that represents an entity that can be contacted by a human being), event (an 
item that records the occurrence of something in the environment), task (an item 
that represents work that is done at a particular point in time or repeatedly over 
time, or as a result of some event other than the passage of time), device (a logical 
structure that supports information processing capabilities), and location (an item 
that represents one physical or geographic space). 

The Base namespace 310 (“System. Storage. Base”) defines types that form 
the foundation of the WinFS file system. These are the types that are typically 
necessary in order for the file system to operate and support the other sub- 
namespaces 302 - 362. These types may be defined in namespace 310 
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(“System.Storage.Base”), or alternatively in file system namespace 206 
(“System. Storage”) . 

As illustrated in Fig. 3, several additional namespaces 312 - 362 are also 
included in file system 206 in addition to the synchronization namespace 302, 
notifications namespace 304, meta namespace 306, core namespace 308, and base 
namespace 310. Each of the additional namespaces 312 - 362 defines a collection 
of related functionality. The determination of which namespace 312 - 362 
particular functionality is to be part of is made by considering at least how tightly 
tied the particular functionality is to other functionality already defined in the 
namespaces 312 - 362. Functionality that is tightly tied together is typically 
included in the same namespace. 

An example of the logical structure of the namespaces 302 - 362 in file 
system namespace 206 can be seen in Fig. 4. Storage engine 370 provides the 
storage for the file system, and in certain embodiments storage engine 370 is a 
relational database. Base namespace 310 is situated on top of storage engine 370 
along with any other types defined in file system namespace 206 - this 
combination may also be referred to as the data model of the file system. Core 
namespace 308 is situated on top of base namespace 310, and one or more of the 
remaining namespaces 312 - 362 of Fig. 3 are situated on top of core namespace 
308 (these namespaces are identified as namespaces 372(1), 372(2), ..., 372(«) in 
Fig. 4). The Meta namespace 306 is situated to the side of namespaces 308, 310, 
and 372, as it is used to describe the types in those namespace 308, 310, and 372. 
One or more applications 374 sit on top of namespaces 372, and also on top of 
core namespace 308, base namespace 310, and meta namespace 306. Thus, 
applications 374 can access and define their own namespaces, building them on 
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top of one or more of base namespace 310, core namespace 308, and namespaces 
372. 

Returning to Fig. 3, a discussion of the functionality defined in the 
namespaces 312 - 362 follows. 

The Contacts (or Contact) namespace 312 (“System.Storage.Contacts” or 
“System.Storage.Contact”) defines types representing entities that a human being 
can contact, such as people, groups, organizations, households, and so forth. The 
way in which such entities could be contacted can vary, such as by electronic mail 
address, phone number, chat address, postal address, and so forth. 

The Documents (or Document) namespace 314 
(“System. Storage.Documents” or “System. Storage.Document”) defines document 
types that can be accessed and used by the other namespaces 302 - 362. These 
document types refer to different document formats that can be accessed and used. 
Some document types may be included by default in namespace 314, and 
application designers can extend these namespace 314 to include different 
document types of their own design and/or choosing. 

The Media namespace 316 (“System. Storage.Media”) defines base types 
used for audio, video, image, and other kinds of media. These base types are 
typically types that can be used by multiple kinds of media (e.g., both audio and 
video). These types can include, for example, types for meta data regarding the 
media (e.g., a history of actions taken with the media (e.g., whether it was edited, 
who it was sent to, etc.), a rating for the media, and so forth). Additional types 
specific to particular kinds of media are defined in the particular namespaces for 
those media (e.g., Audio namespace 318 and Video namespace 320). 



Iee@hayes f*= 



509-324-9256 



19 



MS 1- 1 793US.APP 




1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



The Audio namespace 318 (“System. Storage. Audio”) defines types specific 
to audio media. These types can include, for example, types for meta data 
regarding audio media (e.g., artist name, album name, and so forth). 

The Video namespace 320 (“System.Storage.Video”) defines types specific 
to video media. 

The Images (or Image) namespace 322 (“System. Storage.Images” or 
“System.Storage.Image”) defines types specific to image media. The Images 
namespace 322 includes types used to represent different kinds of images, such as 
properties of file formats for presenting images (e.g., using the GIF, TIFF, JPEG, 
etc. formats), or properties that represent the semantic contents of a file (e.g., 
photographer, people in the image, etc.). 

The Message (or Messages) namespace 324 (“System. Storage.Message” or 
“System.Storage.Messages”) defines types used for any kind of message, such as 
Email messages. Fax messages, IM (instant messaging) messages, and so forth. 
These types are typically types that can be used by multiple kinds of media (e.g., 
both Email messages and IM messages). Additional types specific to particular 
kinds of messages are defined in the particular namespaces for those messages 
(e.g., Fax namespace 326 and Email (or Mail) namespace 328). 

The Fax namespace 326 (“System.Storage.Fax”) defines types specific to 
facsimile messages. These types can include, for example, types for details 
regarding transmission of facsimile messages. 

The Email (or Mail) namespace 328 (“System.Storage.Email” or 
“System.Storage.Mail”) defines types specific to electronic mail messages. 

The Annotation (or Annotations) namespace 330 
(“System. Storage. Annotation” or “System.Storage. Annotations”) defines types 
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linked to one or more pieces of data. Examples of annotations include: a text 
bubble next to a paragraph, a highlight of some text, a margin-bar next to 
paragraphs, an audio comment, an ink-annotation of some text, and so forth. The 
Annotation namespace 330 allows different kinds of data to act as the annotation 
content, and provides a flexible mechanism to specify where the annotation is 
anchored. The annotation system can be, for example, the Common Annotation 
Framework (CAF) - additional details regarding the Common Annotation 
Framework (CAF) are available from Microsoft Corporation of Redmond, 
Washington. 

The Note (or Notes) namespace 332 (“System.Storage.Notes” or 
“System.Storage.Note”) defines types for items which are notes. These notes can 
be, for example, Microsoft® Windows® operating system Journal notes, 
electronic “sticky” notes, and so forth. 

The Programs (or Program) namespace 334 (“System.Storage.Programs” or 
“System.Storage.Program”) defines types that allow a database of programs that 
are installed in the system to be maintained. This database can then be accessed 
by, for example, the operating system or other applications and information 
regarding programs that are installed in the system can be obtained. 

The Explorer namespace 336 (“System.Storage.Explorer”) defines types 
that allow a history list for use with the operating system to be maintained and 
accessed. The history list is, for example, a record of actions taken by the user, 
such as a record of locations in the file system that have been accessed (e.g., a list 
of folders that have been opened as a user navigates through the file system 
looking for a file). 
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The NaturalUI (or NaturalUserlnterface) namespace 338 
(“System.Storage.NaturalUI” or “System. Storage. NaturalUserlnterface”) defines 
types used to support a natural language search engine. The types are used, for 
example, to store data regarding word equivalences, rules, and other aspects of 
natural language processing. 

The ShellTask (or ShellTasks) namespace 340 
(“System.Storage.ShellTask” or “System.Storage.ShellTasks”) defines types used 
to provide lists of tasks in the user interface shell to let users know what actions 
they can perform as they navigate the user interface. The functionality of the 
ShellTask namespace 340 may alternatively be incorporated into the NaturalUI 
namespace 338. 

The UserTask (or UserTasks) namespace 342 (“System.Storage.UserTask” 
or “System.Storage.UserTasks”) defines types used to allow user tasks to be 
created and managed, including being delegated to others, accepted or rejected, 
modified, and so forth. The user tasks are tasks analogous to those often provided 
with personal information manager (PIM) applications, such as jobs to be 
performed, phone calls to make, projects to complete, items to purchase, and so 
forth. The types further allow relationships to be defined, such as a relationship 
between a user task and an event (the event that is supposed to initiate the task), a 
relationship between a user task and a message (the message that notifies or 
reminds the user of the task), a relationship between a user task and a person (such 
as the person that assigned the task, the person to which the task is assigned, and 
so forth). 

The Help (or Assistance) namespace 344 (“System. Storage.Help” or 
“System.Storage.Assistance”) defines types used to allow help information to be 
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1 maintained and accessed. This help information can be displayed to the user (e.g., 

2 when requested by the user) to assist the user in performing various actions when 

3 using the system. 

4 The Services (or Service) namespace 346 (“System.Storage.Services” or 

5 “System.Storage.Service”) defines types that allow service endpoints to be 

6 maintained and accessed. These service endpoints allow users to use services on 

7 the local computing device or over a network, such as the Internet. For example, a 

8 service endpoint could identify a service that is to be used to allow the user to 

9 instant message another user of a different system, or chat with that other user. 

10 The Locations (or Location) namespace 348 (“System. Storage.Locations” 

1 1 or “System.Storage.Location”) defines types used to identify particular physical or 

12 geographic locations. These locations can be, for example, postal addresses or 

13 coordinates (e.g., latitude and longitude type information. Global Positioning 

14 System (GPS) coordinates, and so forth). The locations can be, for example, 
is locations of contacts described using contacts namespace 312. 

16 The Principals (or Principal) namespace 350 (“System.Storage.Principals” 

17 or “System.Storage.Principal”) defines types used to maintain information 
is regarding security principals. A security principal refers to anything in the system 

19 that can have access rights assigned to it (e.g., an item or a resource of the system). 

20 These types in the Principals namespace 350 allow security principals to be 

21 identified and allow the access rights for those security principals to be identified 

22 and assigned (e.g., identifying who or what has access to the security principal). 

23 The Calendar (or Calendars) namespace 352 (“System.Storage.Calendar” or 

24 “System.Storage.Calendars”) defines types used to maintain and access 

25 information regarding appointments and attendees. Appointments may include, 
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for example, information regarding time, location, recurrence, reminders, 
attendees, and so forth, as well as title and message body. Appointment attendees 
may include, for example, email address, availability, and response (e.g., whether 
the attendee accepted or declined the appointment). 

The Watcher namespace 354 (“System.Storage.Watcher”) defines types 
used to allow the creation and management of event monitoring and resultant 
actions. These types allow an interest in the occurrence of some type of event to 
be registered, as well as an indication of what should occur if and when that event 
does occur. When the specified event occurs, the specified action is taken by the 
system. 

The Interop namespace 356 (“System. Storage.Interop”) defines a set of 
namespaces parallel to namespaces 306-354 and 358-362 containing classes used 
by non-managed consumers (consumers not writing to the Common Language 
Runtime). For example, a “System.Storage.Interop.Video” would contain the 
classes related to video media that could be called from unmanaged consumers. 
Alternatively, such classes could live in an “Interop” namespace nested below 
each of the namespaces 306-354 and 358-362. For example, classes related to 
video media that could be called from unmanaged consumers could be located in a 
“System. Storage. Video.Interop” namespace. 

The Files (or File) namespace 358 (“System.Storage.Files” or 
“System. Storage. File”) defines types used to maintain information regarding files 
stored in the file system. These types can include, for example, meta data or 
properties regarding files stored in the file system. Alternatively, these types may 
be defined in the file system namespace 206 (that is, in the System. Storage 
namespace). 
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The GameLibrary (or GameLibraries) namespace 360 
(“System.Storage.GameLibrary” or “System. Storage. GameLibraries”) defines 
types used to represent games that are installed in the system. These types can 
include, for example, meta data regarding games that are installed in the system, 
and types that allow querying so that applications can identify which games are 
installed in the system. 

The CategoryHierarchy (CategoryHierarchies) namespace 362 
(‘ System.Storage.CategoryHierarchy” or “System.Storage.CategoryHierarchies”) 
defines types used to represent and navigate hierarchical category dictionaries. 

Example Namespace Members 

This section includes multiple tables describing the examples of members 
that may be exposed by example namespaces (e.g., namespace in file system 
namespace 206 of Fig. 2). These exposed members can include, for example, 
classes, interfaces, enumerations, and delegates. It is to be appreciated that the 
members described in these examples are only examples, and that alternatively 
other members may be exposed by the namespaces. 

It should be appreciated that in some of namespace descriptions below, 
descriptions of certain classes, interfaces, enumerations and delegates are left 
blank. More complete descriptions of these classes, interfaces, enumerations and 
delegates can be found in the subject matter of the compact discs that store the 
SDK referenced above. 
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Svstem.Storage 

The following tables list examples of members exposed by the 
System. Storage namespace. 



Classes 

AlreadvAssociatedWithltemException 

AlreadvConstructedException 

AlreadvExistsException 

AlreadvSubscribedException 

AsvncException 

AsyncResultException 

BackupOptions 



object has already been 
associated with an ItemContext 

Encapsulates an exception for 
an attempt to instantiate an 
already instantiated object. 

Exception thrown when trying 
to create a object that logically 
already exists 

Encapsulates an exception 
when a data class client 
attempted to subscribe to data 
change notification on a data 
class object it has already 
subscribed to. 

Encapsulates an exception for 
any asynchronous operation 
failure. 

Encapsulates an exception for 
errors encountered in the result 
set of an asynchronous query. 

Encapsulates the options 
available for backing up a item 
to a stream. 

Folder to be deleted must be 
empty 

A Category reference Identity 
key. Every categoryNode has an 
identity key of type 
CategoryRef. When category 
refences are tagged onto an 
item, they are tagged as a link 
type where the Link.Target 
contains a CategoryRef. 



CannotDeleteNonEmptvFolderException 



CategoryRef 
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CategorvRefCollection 

CategorvRefEnumerator 

CategorvRefHolder 

ChangeCollection 

Cl assN otRegisteredEx ception 

CommitOutOfOrderException 

ConnectionException 

ConstraintAttribute 

Container 

ContainerAttribute 

CyclicOwningLinksException 

DateT im eRan geConstraint Attribute 

DecimalRangeConstraintAttribute 

DelavLoad 

Del eteErrorException 

Element 

Extension 



A CategoryRef collection 

A class for enumerating a 
CategoryRef collection 

a class to hold CategoryRef 
objects 

Encapsulates a colleciton of 
changes. 

A CLR class not registered for 
COM-Interop 

outer transaction cannot be 
committed before ending the 
inner transaction 

Encapsulates an exception as a 
result of connection failure in 
WinFS API. 

Base class for constraint 
attributes. 

Encapsulates a container for 
holding other objects. 

a cycle in the object links was 
detected 

Specifies a date range 
constraint on the associated 
property. 

Specifies a decimal range 
constraint on the associated 
property. 

object deletion failed 

Base class for NestedElements 

This is the type used as the 
basis for extensions. To 
establish an extension a new 
subtype of this type is defined. 
The extension may be added to 
an Item by creating an instance 
of the type and assigning it to 
the Extensions field of the Item 
to be extended. 
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Extension Collection 
ExtensionEnumerator 

ExtensionHolder 

FieldAttribute 

Filter 

FilterException 

FlndOptions 

FindResult 

FindResultEnumerator 

FindResultException 

FloatRangeConstraintAttribute 



Folder 

F olderMembersRel ationship 

FolderMembersRelationshipCollection 

IdentityKey 

IdentityKeyCollection 

IdentitvKeyEnumerator 

IdentityKevH older 

IntemalErrorException 

In va 1 1 dObi ectExc-epti on 



A Extension collection 

A class for enumerating a 
Extension collection 

a class to hold Extension 
objects 

Defines the base class for a 
field attribute of an extended 
type. 

Encapsulate a parsed search 
filter expression. 

Encapsulates an exception for 
an invalid filter expression used 
in a query. 

Options used when executing a 
search. 

The FindResult class 
encapsulates a result set of 
query. 

Defines the basic behaviors of a 
FindResultEnumerator object. 
Encapsulates an exception for 
an error encountered in the 
result set of a query. 

Specifies a float range 
constraint on the associated 
property. 



A IdentityKey collection 

A class for enumerating a 
IdentityKey collection 

a class to hold IdentityKey 
objects 

Encapsulates an exception for 
internal errors. 

Encapsulates an exception for 
an invliad object. 
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InvalidParameterException 

InvalidPropertyNameException 



InvalidSortingExpressionException 



InvalidSortingOrderException 
InvalidT vpeCastException 



Item 

ItemContext 



ItemContextNotOpenException 



Itemld 

ItemldReference 

ItemName 

ItemNameCollection 



ItemN ame Enumerator 



ItemNotFoundException 

ItemPathReference 

ItemReference 

ItemSearcher 

Link 



LinkCollection 

LinkEnumerator 



InvalidParameterException. 

Encapsulates an exception for 
an invliad property of a WinFS 
type specified in a filter 
expression. 

the sorting expression is not 
valid 

the sorting order is invalid 

Encapsulates an exception for 
an invliad type cast specified in 
a filter expression. 

An instance of the ItemContext 
class defines an item domain in 
which the owning "Longhorn" 
application operates to create, 
find, change, save and monitor 
items in the underlying 
"WinFS" store. 

exception raised when an 
ItemContext has not been 
opened yet 

Item Id. 

Itemld reference. 

ItemName represents the path 
name of an item 

An ItemNameCollection 
contains all the item names for 
an item 

An ItemNameEnumerator 
allows enumerating an 
ItemN ameC ollection 

item was not found 
Item path reference. 

Item reference. 

Item searcher. 

A Link collection 
A class for enumerating a Link 
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LinkHolder 

LinkRelationshipAttribute 
MaxLengthConstraint Attribute 

MemberN otF oundException 
MultipleHoldingLinksException 

Multi pi eQbi ectsF oundExcepti on 

NestedAttribute 

NestedCollection 



NoOwningElementException 
NoOwningLinkException 
NoRelationshipException 
N ot Associated W ithContextException 



collection 

a class to hold Link objects 

Represents a link relationship 
attribute. 

Specifies a maximum length 
constraint on the associated 
property 

a member was not found in the 
collection 

a newly created item can only 
have one holding link before it 
is saved to the store 

multiple objects were found 
while only one was expected 

Encapsulates an attribute of a 
type nested in an extended type. 
A collection for holding nested 
elements of an item. 



nested element can only be in 
one parent element or item 

Encapsulates an enumerator of 
a nested collection so that the 
collection can be enumerated 
using the foreach ... construct. 

a nested element does not have 
an owning element, nested 
elemented must be kept within 
an item 

An item does not have an 
owning link. In WinFS, evert 
item must have an owning 
(holding) link 

Encapsulates an exception 
when a relationship specified in 
a filter expression cannot be 
found. 

Encapsulates an exception 
when an operation of data class 



NestedElement 

NestedElementHolder 

NestedElementlnMultipleHoldersExcepti 

on 

NestedEnumerator 
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NotConstructedException 
Notification Exception 
NoTvpeMappingException 

NullableConstraintAttribute 

NullPropert yV alueException 
ObiectCollection 

ObiectConversionException 

ObiectException 

ObiectHolder 

Outstanding! 1 ransactionException 
O wn erN otS a vedException 
Parameter 

ParameterCollection 



object not associated with an 
ItemContext instance is 
attempted in a WinFS store. 

Encapsulates an exception for 
an attempt to close an already 
closed or never instanted object. 
Encapsulates an exception for a 
fail condition associated with 
data change notifications. 

Encapsulates an exception 
when a WinFS type specified in 
a query expression is not 
specified in the loaded type 
mappings. 

Specifies whether a property 
marked with this attribute is 
nullable or not. 

null value is not allowed for 
given property 

Used to delay load objects from 
the database. A field that is a 
collection and is delay loadable 
uses this class as a proxy. The 
real objects will be fetched on 
demand. 

cannot convert from one data 
type to another 

Encapsulates an exception for 
an invalid object. 

Used to delay load objects from 
the database. A field that is 
delay loadable uses this class as 
a proxy. The real object will be 
fetched on demand. 

the ItemContext still has 
outstanding transaction 

the owner of the object has not 
been saved yet. 

Represents a parameter name 
and value. 

A collection of parameter 
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PrecisionAndScaleConstraintAttribute 

ProjectionOption 

PropertvConstraintException 

PropertyException 

Query 



RecycleBinLink 

RecycleBinLinkCollection 

RecvcleBinLinkEnumerator 

RecvcleBinLinkHolder 

Relationship 

Relationshipld 

RestoreOptions 

RootltemBase 

ScalarAttribute 

SearcherException 

SearchExpression 

SearchExpressionCollection 

SearchProiection 

SetChangedEventArgs 

Share 

SortingException 



name/ value pairs. 

This attribute specifies a 
precision and scale constraint 
on the associated property. 
Defines a field that is projected 
into the search result, 
property constaint violation 

Encapsulates an exception for 
an invalid property. 

Encapsulates a query consisting 
of the object type, filter string, 
sorting directives, and 
dependent object set. 

A RecycleBinLink collection 

A class for enumerating a 
RecycleBinLink collection 

a class to hold RecycleBinLink 
objects 

Base Relationship class. 
Relationship Id. 

Encapsulates the options for 
restoring an item from a stream. 
The base class of all the item 
data classes. 

Encapsulates a scalar attribute 
of an extended type. 
SearcherException. 

Expression used in a search. 

A collection of 
SearchExpression. 

Contains the results of a search 
projection. 

Encapsulates the arguments 
passed to the 

SetChangedHandler delegate. 

Encapsulates an exception for 
invalid sort primitive specified 
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SortOption 



SortOptionCollection 



Span 



StorageException 



Store 

StoreObiect 



SubscriptionFailException 



Transaction 

TransactionAlreadyCommittedOrRolledB 

ackException 

TransactionException 



Type Attribute 



UnsubscriptionFailException 



UpdateException 



V irt ualRelati onshi pColl ecti on 
Volume 

VolumeCollection 

V olumeEniimerator 

VolumeHolder 



in a query. 

Specifies sorting options used 
in a search. 

A collection of sort option 
objects. 

Encapsulates an object 
dependancy. 

The base class of all exceptions 
thrown by the WinFS API. 

Abstract base class used by 
"WinFS" data classes 

Encapsulates an exception for a 
failed attempt to subscribe to 
data change notification. 

Encapsulates a transaction. 

A transaction has already been 
committed or rolled back 
Encapsulates an exception for 
errors encountered in a 
transactional operation. 

Encapsulate of an attribute of 
an extended "WinFS" type. 

Encapsulates an exception for a 
failed attempt to unsubscribe to 
data change notification. 

Encapsulates an exception for 
errors encountered in an Update 
operation. 

Various utilities used by the 
"WinFS" API 



A Volume collection 

A class for enumerating a 
Volume collection 

a class to hold Volume objects 
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Interfaces 

ICategoryRcfCollection 

1 CategorvRefEnumerator 

IChan geMana ger 
ICollectionBase 

IDataClass 

lElementBase 

1 EnumeratorBase 

lExtensionCollection 

IExtensionEnumerator 

IldentityKevCollection 

IldentitvKevEnumerator 

IltemBase 

ILinkCollection 

ILinkEnumerator 

INestedBase 



An interface representing a CategoryRef 
collection 

interface representing a class for enumerating 
a CategoryRef collection 

To be obsoleted. 

Defines the basic common behaviors of an 
implementing collection classes. 

This interface declares a set of standard 
methods that all data classes must 
implement. 

This interface defines some basic behaviors 
to be implemented by all element data 
classes. 

Defines the basic common behaviors of the 
implementing enumerator classes. 

An interface representing a Extension 
collection 

interface representing a class for enumerating 
a Extension collection 

An interface representing a IdentityKey 
collection 

interface representing a class for enumerating 
a IdentityKey collection 

This interface defines the common behavior 
of all the item-based data classes. 

An interface representing a Link collection 
interface representing a class for enumerating 
a Link collection 

This interface defines the common behaviors 
of nested element classes. 



1 Rec ycleBinLinkCollection An interface representing a RecycleBinLink 

collection 



IRecvcleBinLinkEnumerator interface representing a class for enumerating 

a RecycleBinLink collection 

IVolumeCollection An interface representing a Volume 

collection 

1 V olumeEn umerator interface representing a class for enumerating 

a Volume collection 
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Enumerations 

EventTvpe Called by system.storage.schemas.dll. 

LinkRelationshipPart Defines parts of a link relationship. 

Ran geConstraintT ype Species if a range constraint is constrained by min 

value, max value, or both. 

SetChangedBventT ype This enumeration specifies the types of events in 

which a set changes. 

SortOrder Specifies the sort order used in a SortOption 

object. 



Delegates 

SetChangedHandler Event handler for set changed events. 
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Svstem.Storage. An notation 

The following tables list examples of members exposed by the 



15 



System.Storage. Annotation namespace. 
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Classes 

Annotation Typically an annotation is anchored in 

some context (e.g. the paragraph of some 
text) and contains some cargo (e.g. a text 
comment). Sometimes an annotation 
expresses the relationship between 
multiple contexts (e.g. a comment that 
two paragraphs should be reordered). 

AnnotatorRelationship 

AnnotatorRelationshipCollection 

Content The Content type represents literal 

information, e.g. TextContent, 
XMLContent, Highlight, InkContent, 
etc... The content data must adhere to the 
XSD type in the given namespace URL 
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ContentCollection 

ContentEnumerator 



ContentHolder 

Locator 



LocatorCollection 

LocatorEnumerator 



LocatorHolder 

LocatorPart 



LocatorPartCollection 

LocatorPartEnumerator 



LocatorPartHolder 

RangePart 



RangePartCollection 

RangePartEnumerator 



A Content collection 

A class for enumerating a Content 
collection 

a class to hold Content objects 

A Locator describes the location or the 
identification of a particular datum. A 
Locator contains an ordered collection of 
LocatorParts. Applying each LocatorPart 
successively against an initial context 
will resolve into the particular datum. 

For example: a Locator could have two 
LocatorParts, the first specifying a 
"WinFS" item that is an image, and the 
second specifying a graphical region. If a 
Locator has a Range, its Locators are 
applied after all original LocatorParts 
have been resolved. 

A Locator collection 

A class for enumerating a Locator 
collection 

a class to hold Locator objects 

Each LocatorPart describes location or 
identification of some information in 
some implied context. Examples for 
LocatorPart are: a reference to a 
"WinFS" item, the URI of some 
document, a marker ID, a text offset. The 
data for a LocatorPart must conform to 
the Xsi Type defined in the specified 
namespace. 

A LocatorPart collection 

A class for enumerating a LocatorPart 
collection 

a class to hold LocatorPart objects 

The type RangePart describes the 
location or the identificatio of a range of 
some information. It is composed of two 
Locators. 

A RangePart collection 

A class for enumerating a RangePart 
collection 



lee@hayes p«c 509-324-9256 



36 



MS 1-1 793US.APP 





a class to hold RangePart objects 

A Resource groups identification, 
location, and content of some 
information. It is used for expressing 
contexts as well as cargo. This enables a 
context to cache the underlying data the 
annotation is anchored to (in addition to 
storing a reference to the underlying 
data), and it allows the cargo to be literal 
content, or a reference to already existing 
data, or both. 

A Resource collection 

A class for enumerating a Resource 
collection 

a class to hold Resource objects 

Interfaces 

IContentCollection An interface representing a Content collection 

IContentEnumerator interface representing a class for enumerating a 

Content collection 

ILocatorCol 1 ection An interface representing a Locator collection 

ILocatorEnumerator interface representing a class for enumerating a 

Locator collection 

ILocatorPartCollecti on An interface representing a LocatorPart collection 
ILocatorPartEnumerator interface representing a class for enumerating a 

LocatorPart collection 

IRangePartCol lection An interface representing a RangePart collection 

I Ran gePart Enumerator interface representing a class for enumerating a 

RangePart collection 

IResourceCollection An interface representing a Resource collection 

IResourceEnumerator interface representing a class for enumerating a 

Resource collection 
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1 Svstem.Storage.Annotation.Interop 

2 The following table lists examples of members exposed by the 

3 System. Storage. Annotation.Interop namespace. 
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Interfaces 

IAnnotation Typically an annotation is anchored in some context (e.g. the 
paragraph of some text) and contains some cargo (e.g. a text 
comment). Sometimes an annotation expresses the 
relationship between multiple contexts (e.g. a comment that 
two paragraphs should be reordered). 

IContent The Content type represents literal information, e.g. 

TextContent, XMLContent, Highlight, InkContent, etc... The 
content data must adhere to the XSD type in the given 
namespace URL 

ILocator A Locator describes the location or the identification of a 

particular datum. A Locator contains an ordered collection of 
LocatorParts. Applying each LocatorPart successively against 
an initial context will resolve into the particular datum. For 
example: a Locator could have two LocatorParts, the first 
specifying a "WinFS" item that is an image, and the second 
specifying a graphical region. If a Locator has a Range, its 
Locators are applied after all original LocatorParts have been 
resolved. 

ILocatorPart Each LocatorPart describes location or identification of some 
information in some implied context. Examples for 
LocatorPart are: a reference to a "WinFS" item, the URI of 
some document, a marker ID, a text offset. The data for a 
LocatorPart must conform to the Xsi Type defined in the 
specified namespace. 

I Range Part The type RangePart describes the location or the identificatio 
of a range of some information. It is composed of two 
Locators. 

IResource A Resource groups identification, location, and content of 
some information. It is used for expressing contexts as well 
as cargo. This enables a context to cache the underlying data 
the annotation is anchored to (in addition to storing a 
reference to the underlying data), and it allows the cargo to be 
literal content, or a reference to already existing data, or both. 
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Svstem.Storage.Audio 

The following tables list examples of members exposed by the 
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System.Storage.Audio namespace. 
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Classes 

Album 



AlbumLink 

AlbumLinkCollection 

AlbumLinkEnumerator 



AlbumLinkHol der 
AutoDJ 

AutoDJCollection 

AutoDJEnumerator 



The type Audio. Album represents an 
audio album which may contain several 
tracks. 

This type represents a link from Track to 
Album that this track belongs to. 

A AlbumLink collection 

A class for enumerating a AlbumLink 
collection 

a class to hold AlbumLink objects 



A AutoDJ collection 

A class for enumerating a AutoDJ 
collection 



AutoDJ Holder 
BaseTrack 



LocationReference 



a class to hold AutoDJ objects 

The type Audio.BaseTrack represents 
metadata for an audio track. 

LocationReference type represents a link 
to a Location item. It may be dangling, in 
which case the fields on this type specify 
the location coordinates. 



LocationReferenceCollection A LocationReference collection 

LocationReferenceEnumerator A class for enumerating a 

LocationReference collection 



Location ReferenceHol der 
MetadataLink 



M etadataLi nkColl ection 
MetadataLinkEnumerator 



MetadataLinkHolder 
Physical Track 



a class to hold LocationReference objects 
This type represents a link from 
PhysicalTrack to TrackMetadata. 

A MetadataLink collection 

A class for enumerating a MetadataLink 

collection 

a class to hold MetadataLink objects 
The type Audio.PlatterTrack represents an 
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audio track for which the actual audio data 
is not stored in "WinFS". The Audio bits 
themselves are still on a CD or another 
external storage. 

The type Audio. PlatterTrack represents an 
audio track for which the actual audio data 
is not stored in "WinFS”. The Audio bits 
themselves are still on a CD or another 
external storage. 

The type Audio. PlayList represents an 
audio playlist. 

RadioStation type represents a radio 
station that may provide streams of radio. 

RadioStream type represents a radio 
stream that a radio station provides, it is 
intended to be an embedded item in the 
RadioStation item. 

The type Audio.Track represents an audio 
track that has the actual music data in it. It 
may correspond to a track that has been 
ripped from a CD, or otherwise 
completely stored in "WinFS". 

The type Audio.TrackMetadata contains 
computed or downloaded metadata for 
physical tracks. 

Interfaces 

IAlbumLinkCollection An interface representing a AlbumLink 

collection 

IAlbumLinkEnumerator interface representing a class for 

enumerating a AlbumLink collection 

I AutoD JC ollecti on An interface representing a AutoDJ 

collection 

lAutoDJEnumerator interface representing a class for 

enumerating a AutoDJ collection 

ILocationReferenceCollection An interface representing a 

LocationReference collection 

ILocationReferenceEnumerator interface representing a class for 

enumerating a LocationReference 



PlatterTrack 

PlayList 

RadioStation 

RadioStream 

Track 

TrackMetadata 
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collection 

IMetadataLinkCollection An interface representing a MetadataLink 

collection 

IMetadataLinkEnumerator interface representing a class for 

enumerating a MetadataLink collection 



Svstem.Storage.Audio.Interop 

The following table lists examples of members exposed by the 



System.Storage.Audio.Interop namespace. 



Interfaces 

IAlbum The type Audio. Album represents an audio album 

which may contain several tracks. 

IAIbumLink This type represents a link from Track to Album that 

this track belongs to. 

IAutoDJ 

IBaseTrack The type Audio.BaseTrack represents metadata for an 

audio track. 

ILocationReference LocationReference type represents a link to a 

Location item. It may be dangling, in which case the 
fields on this type specify the location coordinates. 

IMetadataLink This type represents a link from PhysicalTrack to 
TrackMetadata. 

IPhysical Track The type Audio.PlatterTrack represents an audio track 
for which the actual audio data is not stored in 
"WinFS". The Audio bits themselves are still on a CD 
or another external storage. 

IPlatterTrack The type Audio.PlatterTrack represents an audio track 

for which the actual audio data is not stored in 
"WinFS". The Audio bits themselves are still on a CD 
or another external storage. 

IPlavList The type Audio.PlayList represents an audio playlist. 

IRadioStation RadioStation type represents a radio station that may 
provide streams of radio. 

IRadioStream RadioStream type represents a radio stream that a 
radio station provides, it is intended to be an 
embedded item in the RadioStation item. 

ITrack The type Audio.Track represents an audio track that 
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has the actual music data in it. It may correspond to a 
track that has been ripped from a CD, or otherwise 
completely stored in "WinFS". 

ITrackMetadata The type Audio.TrackMetadata contains computed or 
downloaded metadata for physical tracks. 



Svstem.Storage.Contact 



The following tables list examples of members exposed by the 



System. Storage .Contact namespace . 

Classes 

Accreditation 

Accreditation Collecti on 
AccreditationEnumerator 

Accreditation Holder 
ChildData 



ChildDataCollection 

ChildDataEnumerator 

ChildDataHolder 




A wrapper around scalar string to 
support multi-valued strings. 

A Accreditation collection 
A class for enumerating a 
Accreditation collection 
a class to hold Accreditation objects 

Pointer to any COntacts that are 
children of a Person 

A ChildData collection 

A class for enumerating a ChildData 
collection 

a class to hold ChildData objects 
The organization link native to 
employeedata is the link to the 
organization that employs the Person, 
or the employer. This might not be the 
same organization as the one for which 
the Person directly works. Example: 
The employee gets a paycheck from 
Bank of America. The employee 
actually works at the Seattle Branch 
#657. Both are listed as organizations 
as there can be multiple employees, 
but they are independent concepts. 

A EmployeeData collection 
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EmploveeDataHolder 

EmploveeOfRelationship 

EmploveeOfRelationshipCollection 

FullName 



F ullN ameCol 1 ection 
FullNameEnumerator 

FullNameHolder 

GeneralCategories 

Group 



A class for enumerating a 
EmployeeData collection 
a class to hold EmployeeData objects 

The fullname set associated with 
Person.PersonalNames. There can be 
one or many of these, but it is assumed 
that if the contact exists, it has at least 
one name. Names are classified by the 
user with the Item.Categories field, 
which is not shown in this definition, 
but which is part of the combined view 
for Person. Classifications for names 
may include Gamer names, 
professional and personal names. 
Names may represent "contextual 
views" on the Person. One of the 
classifications might be a special- 
cased (e.g. IsDefault) indicating that 
this is the default name. There may be 
one and only one FUllName marked in 
this way. The Person.DisplayName 
value is computed using the 
FullName.DisplayName value of the 
Default Fullname. The default 
category should be manipulated by the 
application and not the user (e.g. check 
box) so that default should not appear 
in the classification section of any UI. 
The first fullname entered should be 
set to default, otherwise there will be 
no Person.DisplayName value 

A FullName collection 

A class for enumerating a FullName 

collection 

a class to hold FullName objects 

partial Contact.GeneralCategories 
class used to list standard category 
keys 

Describes the features of a basic 
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GroupMembership 



GroupMembershipCollection 

GroupMembershipEnumerator 

GroupMembershipHolder 

Household 

HouseholdMemberData 

HouseholdMemberDataCollection 

HouseholdMemberDataEnumerator 

HouseholdMemberDataHolder 

InstantMessagingAddress 



group. This type can be extended by 
specific group providers to incorporate 
information required for their group 
type. The friendly name of the group is 
taken from the group.DisplayName 
which is inherited. 

GroupMembership contains the 
references to members of a particular 
group. This is a link type between 
Person and Group. Group is the 
owning side of the link. Being derived 
from NestedElement, there is an 
inherited categories field that contains 
any number of classifications 
associated with this group member. 

A GroupMembership collection 

A class for enumerating a 
GroupMembership collection 

a class to hold GroupMembership 
objects 

A household is a set of individuals 
who all live in the same house. Note 
that household does not imply family, 
for example, a group of roommates 
form a household but not a family. 

The actual references to household 
membership 

A HouseholdMemberData collection 

A class for enumerating a 
HouseholdMemberData collection 
a class to hold HouseholdMemberData 
objects 

The Presences representation of any 
EAddress.AccessPoint where the 
Eaddress.ServiceType = "IM". This 
allows the application to quickly find 
all of the presence status' for a given 
IM address 



InstantMessagingAddressCollection A InstantMessagingAddress collection 
InstantMessagingAddressEnumerat A class for enumerating a 
or InstantMessagingAddress collection 
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InstantMessagingAddressHolder 
LocalMachineDataF older 



MemberOfGroiipsRelationship 

MemberOfGroupsRelationshipColl 

ection 

Organization 



Person 



PresenceService 

SecuritvID 
SecuritvIDCollection 
Security lD Enumerator 



a class to hold 

InstantMessagingAddress objects 

Used to hold machine profile 
information. This can be transferred 
with contacts when contacts are 
backed up or turned into a portable 
profile. It indicates where the contacts 
came from when it is not the local 
machine. It also contains machine 
wide information, such as 
EVERYONE, ADMINISTRATOR, 
etc. security groups. 



The organization information that may 
be associated with employeedata as the 
employer, the department within the 
employer's organization or be a stand 
alone entity. The friendly or display 
name for the organization is inherited. 

Information specific to a Person, 
where a Person references one and 
only one real world person Note that 
there is an explicit ExpirationDate 
rather than using the Item.EndDate. It 
is unclear whether or not the Person 
should be removed from the system 
based upon the Item.EndDate, but the 
notion here is that the EndDate may 
simply be used to indicate that the 
Person is no longer an active contact 
rather than one that should be removed 
upon reaching a certain date. The 
expirationdate is explicitly to be used 
to remove unwanted contacts. 

Service that is able to provide presence 
information. 

The user’s Local SID 
A SecuritylD collection 
A class for enumerating a SecuritylD 
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collection 

a class to hold SecuritylD objects 
SMTPEmail is derived from eaddress 
and schematizes only one of several 
different types of possible email. The 
purpose in schematizing SMTP email 
is to allow users to search/query on the 
domain value, just as they can query 
on postal code or area code. SMTP is 
probably the most common of the 
email address types available on the 
internet. Schematization requires 
parsing the Eaddress.AccessPoint 
string into the appropriate components. 
For example, if EAddress. AccessPoint 
= "blacknight@earthlink.net" then 
SMTPEmail Address .usemame—'black 
night" and 

SMTPEmailAddress.domain- 'earthlin 
k.net" 

A SmtpEmailAddress collection 

A class for enumerating a 
SmtpEmailAddress collection 
a class to hold SmtpEmailAddress 
objects 

Pointer to a Contact that is a spouse of 
a Person 

A SpouseData collection 

A class for enumerating a SpouseData 
collection 

a class to hold SpouseData objects 

The schematized AccessPoint instance 
value using the AccessPoint template 
when the E Address. ServiceType is one 
of the category type telephone. The 
purpose is to allow the user to quickly 
query for all numbers within a country 
code or an area code. 

A TelephoneNumber collection 
A class for enumerating a 
TelephoneNumber collection 
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a class to hold TelephoneNumber 
objects 

A Template is a pre-set format for a 
particular Type that may be surface in 
the UI as a input mask or used by an 
application or API as a validation 
requirement. Templates allow for the 
fact that many element types have one 
or more known and expected formats. 
Data entered that does not meet one of 
these templates can cause applications 
and/or processes to break. Any type, 
however, might support multiple 
templates. For instance, a phone 
number might legitimately take the 
form of either 1 -800-FLOWERS or 1- 
800-356-9377. Both are representative 
of a phone number. Understanding the 
template associated with the specific 
instance is also a boon when 
translating the value in the UI. For 
example, an application being 
executed on a "Longhorn" device in a 
country where letters are not typically 
available on phones might need to 
translate the phone number stored 
using the Template N-NNN- 
AAAAAAA before rendering. The 
template may be exposed to the user 
for selection or may be selected by the 
application itself. 

Specialized folder representing 
information that belongs only to this 
user, e.g., ..\dejans\documents. There 
is one per user on a machine. The 
PersonalContacts virtual folder is 
rooted to this folder, as are temporary 
and MFU folders. 

WeblogAddress is a user's weblog, or 
"homepage", address. 

A WeblogAddress collection 
A class for enumerating a 
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WeblogAddress collection 

WeblogAddressHolder a class to hold WeblogAddress objects 

WellKnownFolder Meant to be the base class for any 

specialized sub folder that contains 
well understood information, i.e., any 
folder that is known in the system - 
such as userdatafolder, temporary 
folders, MRU folders, etc. This would 
include such virtual folders as 
"temporary", "MFU/MRU", etc. The 
folder types indicate how the folder is 
used and acted upon. For instance. 
Temporary and MFU folder contents 
are not exposed as Contacts in 
MyContacts. 

WindowsPresence General IM presence shown in the 

Shell. Presence provider can be MSN, 
Exchange, Yahoo, etc. 

WindowsPresenceCollection A WindowsPresence collection 

WindowsPreseneeEnumerator A class for enumerating a 

WindowsPresence collection 

W indo wsPresenceHolder a class to hold WindowsPresence 

objects 



Interfaces 

IAccreditationCollection 

IAccreditationEnumerator 

IChildDataCollection 

IChildDataEnumerator 

IEmployeeDataCollection 

lEmployeeDataEnumerator 



An interface representing a 
Accreditation collection 

interface representing a class for 
enumerating a Accreditation 
collection 

An interface representing a 
ChildData collection 
interface representing a class for 
enumerating a ChildData collection 
An interface representing a 
EmployeeData collection 

interface representing a class for 
enumerating a EmployeeData 
collection 
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IFullNameCollection 



IFullNameEnumerator 



IGroupMembershipCollection 

IGroupMembershipEnumerator 



rHouseholdMemberDataCollection 



IHouseholdMemberDataEnumerator 



An interface representing a 
FullName collection 
interface representing a class for 
enumerating a FullName collection 

An interface representing a 
GroupMembership collection 

interface representing a class for 
enumerating a GroupMembership 
collection 

An interface representing a 
HouseholdMemberData collection 



interface representing a class for 
enumerating a 

HouseholdMemberData collection 

IlnstantMessagingAddressCollection An interface representing a 

InstantMessagingAddress 

collection 

HnstantMessagingAddressEnumerator interface representing a class for 

enumerating a 

InstantMessagingAddress 

collection 



ISecuritvIDCollection 



ISecuritvIDEnumerator 



ISmtpEmailAddressCollection 

ISmtpEmailAddressEnumerator 



IS pouseDataCollection 



ISpouseDataEnumerator 



IT elephoneNumberCollecti on 
ITelephoneNumberEnumerator 



An interface representing a 
SecuritylD collection 

interface representing a class for 
enumerating a SecuritylD 
collection 

An interface representing a 
SmtpEmailAddress collection 

interface representing a class for 
enumerating a SmtpEmailAddress 
collection 

An interface representing a 
SpouseData collection 

interface representing a class for 
enumerating a SpouseData 
collection 

An interface representing a 
TelephoneNumber collection 

interface representing a class for 
enumerating a TelephoneNumber 
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IWindowsPresenceCollection 

IWindowsPresenceEnumerator 

Enumerations 

WindowsPresenceStatus 



collection 

An interface representing a 
Weblog Address collection 

interface representing a class for 
enumerating a WeblogAddress 
collection 

An interface representing a 
WindowsPresence collection 

interface representing a class for 
enumerating a WindowsPresence 
collection 



Svstem.Storage.Contact.Interoi 



The following table lists examples of members exposed by the 
System.Storage.Contact.Interop namespace. 



Interfaces 

IAccreditation A wrapper around scalar string to support 

multi-valued strings. 

IChildData Pointer to any COntacts that are children of a 

Person 

IEmploveeData The organization link native to employeedata 

is the link to the organization that employs the 
Person, or the employer. This might not be the 
same organization as the one for which the 
Person directly works. Example: The 
employee gets a paycheck from Bank of 
America. The employee actually works at the 
Seattle Branch #657. Both are listed as 
organizations as there can be multiple 
employees, but they are independent concepts. 
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The fullname set associated with 
Person.PersonalNames. There can be one or 
many of these, but it is assumed that if the 
contact exists, it has at least one name. Names 
are classified by the user with the 
Item.Categories field, which is not shown in 
this definition, but which is part of the 
combined view for Person. Classifications for 
names may include Gamer names, 
professional and personal names. Names may 
represent "contextual views" on the Person. 
One of the classifications might be a special- 
cased (e.g. IsDefault) indicating that this is the 
default name. There may be one and only one 
FUllName marked in this way. The 
Person.DisplayName value is computed using 
the FullName.DisplayName value of the 
Default Fullname. The default category 
should be manipulated by the application and 
not the user (e.g. check box) so that default 
should not appear in the classification section 
of any UI. The first fullname entered should 
be set to default, otherwise there will be no 
Person.DisplayName value 

IGroup Describes the features of a basic group. This 

type can be extended by specific group 
providers to incorporate information required 
for their group type. The friendly name of the 
group is taken from the group.DisplayName 
which is inherited. 

IGroupMembership GroupMembership contains the references to 

members of a particular group. This is a link 
type between Person and Group. Group is the 
owning side of the link. Being derived from 
NestedElement, there is an inherited 
categories field that contains any number of 
classifications associated with this group 
member. 

[Household A household is a set of individuals who all 

live in the same house. Note that household 
does not imply family, for example, a group 
of roommates form a household but not a 
family. 
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IHouseholdMemberData The actual references to household 



membership 

I InstantMessaging Address The Presences representation of any 

EAddress.AccessPoint where the 
Eaddress.ServiceType = "IM". This allows the 
application to quickly find all of the presence 
status' for a given IM address 

ILocalMachineDataFolder Used to hold machine profile information. 

This can be transferred with contacts when 
contacts are backed up or turned into a 
portable profile. It indicates where the 
contacts came from when it is not the local 
machine. It also contains machine wide 
information, such as EVERYONE, 
ADMINISTRATOR, etc. security groups. 

IOrganization. The organization information that may be 

associated with employeedata as the 
employer, the department within the 
employer's organization or be a stand alone 
entity. The friendly or display name for the 
organization is inherited. 

IPerson Information specific to a Person, where a 

Person references one and only one real world 
person Note that there is an explicit 
ExpirationDate rather than using the 
Item.EndDate. It is unclear whether or not the 
Person should be removed from the system 
based upon the Item.EndDate, but the notion 
here is that the EndDate may simply be used 
to indicate that the Person is no longer an 
active contact rather than one that should be 
removed upon reaching a certain date. The 
expirationdate is explicitly to be used to 
remove unwanted contacts. 

IPresenceService Service that is able to provide presence 

information. 



ISecuritvID The user's Local SID 

ISecuritvIDCustom 

ISmtpEmailAddress SMTPEmail is derived from eaddress and 

schematizes only one of several different 
types of possible email. The purpose in 
schematizing SMTP email is to allow users to 
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search/query on the domain value, just as they 
can query on postal code or area code. SMTP 
is probably the most common of the email 
address types available on the internet. 
Schematization requires parsing the 
Eaddress.AccessPoint string into the 
appropriate components. For example, if 
E Address. AccessPoint = 
"blacknight@earthlink.net" then 
SMTPEmailAddress.usemame-'blacknight" 
and 

SMTPEmailAddress.domain- 'earthlink.net" 





Pointer to a Contact that is a spouse of a 
Person 



IT elephoneNumber The schematized AccessPoint instance value 

using the AccessPoint template when the 
EAddress.ServiceType is one of the category 
type telephone. The purpose is to allow the 
user to quickly query for all numbers within a 
country code or an area code. 

ITemplate A Template is a pre-set format for a particular 

Type that may be surface in the UI as a input 
mask or used by an application or API as a 
validation requirement. Templates allow for 
the fact that many element types have one or 
more known and expected formats. Data 
entered that does not meet one of these 
templates can cause applications and/or 
processes to break. Any type, however, might 
support multiple templates. For instance, a 
phone number might legitimately take the 
form of either 1-800-FLOWERS or 1-800- 
356-9377. Both are representative of a phone 
number. Understanding the template 
associated with the specific instance is also a 
boon when translating the value in the UI. For 
example, an application being executed on a 
"Longhorn" device in a country where letters 
are not typically available on phones might 
need to translate the phone number stored 
using the Template N-NNN-AAAAAAA 
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before rendering. The template may be 
exposed to the user for selection or may be 
selected by the application itself. 

IUserDataF older Specialized folder representing information 

that belongs only to this user, e.g., 
..\dejans\documents. There is one per user on 
a machine. The PersonalContacts virtual 
folder is rooted to this folder, as are temporary 
and MFU folders. 

IWeblogAddress WeblogAddress is a user's weblog, or 

"homepage", address. 

IWellKnownFolder Meant to be the base class for any specialized 

sub folder that contains well understood 
information, i.e., any folder that is known in 
the system - such as userdatafolder, temporary 
folders, MRU folders, etc. This would include 
such virtual folders as "temporary", 
"MFU/MRU", etc. The folder types indicate 
how the folder is used and acted upon. For 
instance, Temporary and MFU folder contents 
are not exposed as Contacts in MyContacts. 

IWindowsPresence General IM presence shown in the Shell. 

Presence provider can be MSN, Exchange, 
Yahoo, etc. 



Svstem.Storage.Core 

The following tables list examples of members exposed by the 



System.Storage.Core namespace. 



Classes 

Address Address represents an address for 

contacting or a Contact via postal mail, or 
an indoor/outdoor location in the 
Location object. 

AddressCollection A Address collection 

AddressEnumerator A class for enumerating a Address 

collection 
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AddressH older a class to hold Address objects 

ADSynchronization Synchronization parameters. 

ADSynchronizationCollection A ADSynchronization collection 

ADSynchronlzationEnumerator A class for enumerating a 

ADSynchronization collection 

ADSvnchronizationHolder a class to hold ADSynchronization 

objects 

Author A link to person or company who is an 

author (or a co-author in case of multiple 
authors) 

AuthorCollection A Author collection 

AuthorEnumerator A class for enumerating a Author 

collection 



AuthorHolder 
AuthorRelationship 
AuthorRelationshipCol lection 
BasicPresence 



BasicPresenceCollection 

BasicPresenceEnumerator 



BasicPresenceHolder 

CalendarEvent 

CalendarEventCollection 

CalendarEventEnumerator 



CalendarEventH older 

CategorizedNestedElement 

Category 



a class to hold Author objects 



It is expected that BasicPresence will be 
extended. For example, supporting IRC 
(Internet Relay Chat) presence. An 
example of an IRCPresence is. - DonH = 
Identity Key - editing some.xls = 
IRCPresence (what is involved is given 
by IRCPresence) - on some machine = 
eAddress (where Don is presently editing 
the XLS is given by eAddress) 

A BasicPresence collection 

A class for enumerating a BasicPresence 
collection 

a class to hold BasicPresence objects 

A CalendarEvent collection 

A class for enumerating a CalendarEvent 
collection 

a class to hold CalendarEvent objects 
A nested Element with categories field. 

This represents the valid categories 
known to the current system. Categories 
(also known as taxonomies) include such 
things as the type values for eAddresses. 
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C ate gorvKe vw ord Keyword used for categorizing/grouping 

an item. 

CategoryKeywordCollection A CategoryKeyword collection 

CategorvKevwordEnumerator A class for enumerating a 

CategoryKeyword collection 

CategoryKeywordHolder a class to hold CategoryKeyword objects 

Commodity An identifiable thing that has value - this 

includes inanimate objects such as cars, 
houses, or furniture and animate objects 
such as pets or livestock. 

CommoditvOwnerRelationship 

CommodityOwnerRelationshipC 

ollection 

ComponentRelationship 

ComponentRelationshipCollecti 

on 

Computer 

Contact 

Date This type represents a Date that can be 

used on a document. 

DateCollection A Date collection 

DateEnumerator A class for enumerating a Date collection 

DateHolder a class to hold Date objects 

Device A Device is a logical structure that 

supports information processing 
capabilities, for example a display device 
can translate a bit stream into images, a 
disk drive can store and retrieve bit 
streams, a keyboard can translate 
keystrokes into appropriate codes, a radio 
can select signal streams and translate 
them into sound. 



Document Document is an Item that represents 

content that is authored, can be rendered 
and needs to be stored. 

EAddress An eAddress is essentially a routing 

address, i.e., an electronic way of getting 
in touch with a person. Types of 
eAddresses include o Email address o 
Phone number o WebSite o FTP Site o 
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IntemetFreebusy Location o Netmeeting 
settings. eAddresses may be published to 
allow someone to contact me - for 
example, I tell someone my phone 
number or email address. This contrasts 
with IdentityKeys, which are used to 
obtain information about someone - for 
example, if I want to keep someone's 
address information synchronised and up 
to date, they will have to give me an 
IdentityKey that I can use to obtain the 
information about them from the server. 

EAddressCollection A EAddress collection 

EAddressEnumerator A class for enumerating a EAddress 

collection 



EAddressHolder a class to hold EAddress objects 

Event An Item that records the occurrence of 

something in the environment. Currently 
being used to model Calendar-type events 
— this is a placeholder to be integrated 
with / replaced by the Calendar schema. 

E ventB od vRel ationship 

EventB odyRel ationshipCollectio 

n 



EventExtension 

EventExtensionCollection A EventExtension collection 

EventExtensionEnumerator A class for enumerating a 

EventExtension collection 



EventExtensionHolder 

Flow 



FlowConstraint 



a class to hold EventExtension objects 

The Core.Flow Item type represents the 
graph of related tasks and their 
attachments: Past History, Current Tasks 
and Tasks not yet Started (Plan) 

The FlowConstraint type defines a 
constraint applicable to the relationship 
between a Task Item and a Flow Item. 



FlowConstraintCollection A FlowConstraint collection 

FI owConstraintEnumerator A class for enumerating a FlowConstraint 

collection 



FlowConstraintHolder 



a class to hold FlowConstraint objects 
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Flow Link 


the Core.FlowLink type defines the 
relationship between a Task and the Flow 
for that task. 


FlowLinkCollection 


A FlowLink collection 


FlowLink Enumerator 


A class for enumerating a FlowLink 
collection 


FlowLinkHolder 

Function 

HasLocationsRelationship 

HasLocationsRel ationshipColl ec 
tion 


a class to hold FlowLink objects 


Internal Address Line 


A wrapper around scalar string to support 
multi-valued strings. Used by 
Core.Address.IntemalAddresses. 


Internal AddressLineCollecti on 


A IntemalAddressLine collection 


InternalAddressLineEnumerator 


A class for enumerating a 
IntemalAddressLine collection 


Internal AddressLineHolder 


a class to hold IntemalAddressLine 
objects 


ItemCategorvRelationship 

ItemCategoryRelationshipCollec 

tion 

Keyword 


This type represents a keyword that can 
be used on a document. 


KevwordCollection 


A Keyword collection 


KeywordEnumerator 


A class for enumerating a Keyword 
collection 


KeywordHol der 


a class to hold Keyword objects 


Location 


A Location corresponds to one physical 
or geographic space. A Location is a 
collection of "location elements", each of 
which independently specifies the 
physical space. For example, a person's 
current location may be alteratively 
specified by sensor data (GPS or 802.1 1 
location elements), a postal address, or by 
an ID that resolves against a location 
database via a service. 


LocationElement 


An "atom" of location information. 
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Location Report 



LocationReportCollection 

LocationReportEnumerator 

LocationReportHolder 

Locations Location El ementsRel 
ationship 

Locations LocationElementsRel 

ationshipCollection 

Message 

OfficeDocument 



The Location Report holds the data that 
the Location Service tags onto the 
LocationElements that it produces. 

A LocationReport collection 

A class for enumerating a LocationReport 

collection 

a class to hold LocationReport objects 



Placeholder for a Message. 

Root type for all kinds of office 
documents like word processors, 
spreadsheets etc 



PreviewRelationship 

PreviewRelationshipCollection 

PreviousVersionRelationship 

PreviousVersionRelationshipCol 

lection 

PublisherRelationship 

PublisherRelationshipCollection 

RichText 



A multivalued list of links pointing to any 
attachments associated with the entry, 
such as photos, documents, etc. In the 
Core schema because Core.Contact needs 



RichTextCollection 
RichT extEnumerator 



A RichText collection 

A class for enumerating a RichText 
collection 



RichTextHolder a class to hold RichText objects 

RoleOccupancy This is a relationship between two 

Principals in which one Principal (the 
RoleOccupant) is the occupant of the 
role, and the other Principal is the context 
in which the RoleOccupancy takes place. 
For example a Person (the RoleOccupant) 
may be an employee (the 
RoleOccupancy) of an Organization (the 
RolesContext). 
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RoleOccupancvCollection 

RoleOccupancvEnumerator 

Rol eOccupanc vHolder 
Service 



ShellExtension 



ShellExtensionCollection 
ShellExtension Enumerator 



ShellExtensionHolder 

Task 



TaskChangeEvent 

TaskChangeEventCollection 
T askChangeE ventEnumerator 

T askChan geE ventHol der 
TaskExtension 
TaskExtensionCollection 
T askExtensionEnumerator 



TaskExtensionHolder 

TextDocument 



TextDocumentCollection 



A RoleOccupancy collection 

A class for enumerating a 
RoleOccupancy collection 

a class to hold RoleOccupancy objects 

The base class from which all other 
services are derived. Services are 
providers of information. 

Extension containing categorizing 
keywords. These can be attached to any 
item. 

A ShellExtension collection 

A class for enumerating a ShellExtension 

collection 

a class to hold ShellExtension objects 

A task represents unit of work that is 
done at a particular point in time or 
repeatedly over time. Tasks may also be 
done as a result of some event other than 
the passage of time. Tasks are not the 
same as Functions. Functions are things 
that the system can do such as "Print a 
File" or "Backup a Directory" - Tasks 
record when or under what circumstances 
something should be done or has been 
done not what is done. 

Record of changing a Task associated 
with a Flow 

A TaskChangeEvent collection 

A class for enumerating a 
TaskChangeEvent collection 

a class to hold TaskChangeEvent objects 

A TaskExtension collection 

A class for enumerating a TaskExtension 
collection 

a class to hold TaskExtension objects 

This is a common type for all documents 
that contain texts. This includes Word 
Documents, Journal notes, etc. 

A TextDocument collection 
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T extDocumentEnumerator 



TextDocumentHolder 

TriggeredEvent 



TriggeredEventCollection 
Tri ggeredEventEnumerator 

TriggeredEventHolder 

Uri 

UriCollection 

UriEnumerator 

UriHolder 



A class for enumerating a TextDocument 
collection 

a class to hold TextDocument objects 

This is an event based on a calendar 
schedule. This happens at a certain 
time(s) of a day. 

A TriggeredEvent collection 

A class for enumerating a TriggeredEvent 
collection 

a class to hold TriggeredEvent objects 
URL Used by the Service Item. 

A Uri collection 

A class for enumerating a Uri collection 
a class to hold Uri objects 
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Interfaces 

lAddressCollection An interface representing a Address 

collection 



IAddressEnumerator interface representing a class for 

enumerating a Address collection 

lADSvnchronizationCollection An interface representing a 

ADSynchronization collection 

lADSynchronizationEnumerator interface representing a class for 

enumerating a ADSynchronization 
collection 



IAuthorCollection 



An interface representing a Author 
collection 



IAuthorEnumerator interface representing a class for 

enumerating a Author collection 

IBasicPresenceCollection An interface representing a 

BasicPresence collection 



IBasicPresenceEnumerator 



ICalendarEventCollection 



ICalendarEventEnumerator 
ICategoryKeywordCol lection 



interface representing a class for 
enumerating a BasicPresence collection 

An interface representing a 
CalendarEvent collection 

interface representing a class for 
enumerating a CalendarEvent collection 

An interface representing a 
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CategoryKeyword collection 

ICategorvKevwordEnumerator interface representing a class for 

enumerating a CategoryKeyword 
collection 

IDateCollection An interface representing a Date 

collection 

IDateEnumerator interface representing a class for 

enumerating a Date collection 

IEAddressCollection An interface representing a EAddress 

collection 

IEAddressEnumerator interface representing a class for 

enumerating a EAddress collection 

IEventExtensionCollection An interface representing a 

EventExtension collection 

IEventExtensionEnumerator interface representing a class for 

enumerating a EventExtension collection 

IFlowConstraintCollection An interface representing a 

FlowConstraint collection 

IFlowConstraintEnumerator interface representing a class for 

enumerating a FlowConstraint collection 

IFlowLinkCollection An interface representing a FlowLink 

collection 

IFlowLinkEnumerator interface representing a class for 

enumerating a FlowLink collection 

IlntemalAddressLineCollection An interface representing a 

IntemalAddressLine collection 

IlntemalAddressLineEnumerator interface representing a class for 

enumerating a IntemalAddressLine 
collection 

IKeywordCollection An interface representing a Keyword 

collection 

IKeywordEnumerator interface representing a class for 

enumerating a Keyword collection 

ILocationReportCollection An interface representing a 

LocationReport collection 

ILocationReportEnumerator interface representing a class for 

enumerating a LocationReport collection 

IRichTextCollection An interface representing a RichText 

collection 
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IRichTextEnumerator 

IRoleOccupancyCollection 

IRoleOccupancyEnumerator 

IShellExtensionCollection 

IShellExtensionEnumerator 

ITaskChan geEventCollecti on 

IT askChan geEventEnumerator 

ITaskExtensionCollection 
IT askExtensionEnumerator 
IT extDocum entColIection 
ITextDocumentEnumerator 
ITriggeredEventCollection 
ITriggeredEventEnumerator 
lUriCollection 
IUri Enumerator 



interface representing a class for 
enumerating a RichText collection 
An interface representing a 
RoleOccupancy collection 

interface representing a class for 
enumerating a RoleOccupancy collection 
An interface representing a 
ShellExtension collection 

interface representing a class for 
enumerating a ShellExtension collection 

An interface representing a 
TaskChangeEvent collection 

interface representing a class for 
enumerating a TaskChangeEvent 
collection 

An interface representing a 
TaskExtension collection 

interface representing a class for 
enumerating a TaskExtension collection 

An interface representing a 
TextDocument collection 

interface representing a class for 
enumerating a TextDocument collection 

An interface representing a 
TriggeredEvent collection 
interface representing a class for 
enumerating a TriggeredEvent collection 

An interface representing a Uri 
collection 

interface representing a class for 
enumerating a Uri collection 



Enumerations 

IdentitvCardAttribute 
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Svstem.Storage.Core.Intero 




The following table lists examples of members exposed by the 
System.Storage.Core. Interop namespace. 



Interfaces 

IAddress Address represents an address for contacting 

or a Contact via postal mail, or an 
indoor/outdoor location in the Location 
object. 

IADSvnchronization Synchronization parameters. 

IAuthor A link to person or company who is an author 

(or a co-author in case of multiple authors) 

IBaslcPresence It is expected that BasicPresence will be 

extended. For example, supporting IRC 
(Internet Relay Chat) presence. An example 
of an IRCPresence is. - DonH = IdentityKey - 
editing some.xls = IRCPresence (what is 
involved is given by IRCPresence) - on some 
machine = eAddress (where Don is presently 
editing the XLS is given by eAddress) 

ICalendarEvent 

ICategorizedNestedElement A nested Element with categories field. 

ICategorv This represents the valid categories known to 

the current system. Categories (also known as 
taxonomies) include such things as the type 
values for eAddresses. 

ICategoryKevword Keyword used for categorizing/grouping an 

item. 



ICommodit'i 



An identifiable thing that has value - this 
includes inanimate objects such as cars, 
houses, or furniture and animate objects such 
as pets or livestock. 



IComputer 
I Contact 
IContactCustom 
IDate 



IDevice 



This type represents a Date that can be used 
on a document. 

A Device is a logical structure that supports 
information processing capabilities, for 
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1 Document 



IEAddress 



lEvent 



IEventExtension 

IFlow 



IFlowConstraint 



IFlovvLink 



IFunction 



example a display device can translate a bit 
stream into images, a disk drive can store and 
retrieve bit streams, a keyboard can translate 
keystrokes into appropriate codes, a radio can 
select signal streams and translate them into 
sound. 

Document is an Item that represents content 
that is authored, can be rendered and needs to 
be stored. 

An eAddress is essentially a routing address, 
i.e., an electronic way of getting in touch with 
a person. Types of eAddresses include o 
Email address o Phone number o WebSite o 
FTP Site o IntemetFreebusy Location o 
Netmeeting settings. eAddresses may be 
published to allow someone to contact me - 
for example, I tell someone my phone number 
or email address. This contrasts with 
Identity Keys, which are used to obtain 
information about someone - for example, if I 
want to keep someone's address information 
synchronised and up to date, they will have to 
give me an IdentityKey that I can use to 
obtain the information about them from the 
server. 

An Item that records the occurrence of 
something in the environment. Currently 
being used to model Calendar-type events — 
this is a placeholder to be integrated with / 
replaced by the Calendar schema. 

The Core.Flow Item type represents the graph 
of related tasks and their attachments: Past 
History, Current Tasks and Tasks not yet 
Started (Plan) 

The FlowConstraint type defines a constraint 
applicable to the relationship between a Task 
Item and a Flow Item. 

the Core.FlowLink type defines the 
relationship between a Task and the Flow for 
that task. 
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1 IntemalAddressLine 

] Keyword 
I Location 



I LocationElement 
ILocationReport 



IMessage 

IOfficeDocument 



IRichText 



IRoleOccupancv 



IService 



IShellExtension 



ITask 



A wrapper around scalar string to support 
multi-valued strings. Used by 
Core.Address.IntemalAddresses. 

This type represents a keyword that can be 
used on a document. 

A Location corresponds to one physical or 
geographic space. A Location is a collection 
of "location elements", each of which 
independently specifies the physical space. 

For example, a person's current location may 
be alteratively specified by sensor data (GPS 
or 802.1 1 location elements), a postal address, 
or by an ID that resolves against a location 
database via a service. 

An "atom" of location information. 

The Location Report holds the data that the 
Location Service tags onto the 
LocationElements that it produces. 

Placeholder for a Message. 

Root type for all kinds of office documents 
like word processors, spreadsheets etc 

A multivalued list of links pointing to any 
attachments associated with the entry, such as 
photos, documents, etc. In the Core schema 
because Core.Contact needs it. 

This is a relationship between two Principals 
in which one Principal (the RoleOccupant) is 
the occupant of the role, and the other 
Principal is the context in which the 
RoleOccupancy takes place. For example a 
Person (the RoleOccupant) may be an 
employee (the RoleOccupancy) of an 
Organization (the RolesContext). 

The base class from which all other services 
are derived. Services are providers of 
information. 

Extension containing categorizing keywords. 
These can be attached to any item. 

A task represents unit of work that is done at a 
particular point in time or repeatedly over 
time. Tasks may also be done as a result of 
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ITaskExtension 

ITextDocument 




some event other than the passage of time. 
Tasks are not the same as Functions. 

Functions are things that the system can do 
such as "Print a File" or "Backup a Directory" 
- Tasks record when or under what 
circumstances something should be done or 
has been done not what is done. 

Record of changing a Task associated with a 
Flow 

This is a common type for all documents that 
contain texts. This includes Word Documents, 
Journal notes, etc. 

This is an event based on a calendar schedule. 
This happens at a certain time(s) of a day. 

URL Used by the Service Item. 




The following tables list examples of members exposed by the 



System.Storage.Explorer namespace. 



Classes 

AuditEvent 

AuditEventElement 

AuditEventElementCollection A AuditEventElement collection 
AuditEventElementEnumerator A class for enumerating a 

AuditEventElement collection 



AuditEventElementHol der 
History 

HistoryDownload 
HistoryDownloadColiection 
HistoryDownl oadEnumerator 




a class to hold AuditEventElement objects 

A HistoryDownload collection 

A class for enumerating a 
HistoryDownload collection 

a class to hold HistoryDownload objects 
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HistorvElementCollection 

HistorvElementEnumerator 



HistorvElementHolder 
HistoryVisit 
HistoryVisitCollection 
Hi story V i sitEnumerator 

HistorvVisitHolder 

IntemetShortcut 

Share 

Thumbnail 

Thumbnail Cache 

ThumbnailCacheCollection 

ThumbnailCacheEnumerator 



ThumbnailCacheHolder 

UsagePattem 



UsagePattemEntrv 



UsagePattemEntrvCollection 

UsagePattemEntryEnumerator 

UsagePattemEntrvH older 



A HistoryElement collection 

A class for enumerating a HistoryElement 
collection 

a class to hold HistoryElement objects 

A HistoryVisit collection 

A class for enumerating a HistoryVisit 
collection 

a class to hold HistoryVisit objects 



A ThumbnailCache collection 

A class for enumerating a 
ThumbnailCache collection 

a class to hold ThumbnailCache objects 

UsagePattem item is type of folder that 
contains usage pattern entries. It also 
contains max number of entries. 

Link to item that is remembered in usage 
pattern. Also contains deep copy of 
property that is being remembered. 

A UsagePattemEntry collection 

A class for enumerating a 
UsagePattemEntry collection 

a class to hold UsagePattemEntry objects 



Interfaces 

lAuditEventElementCollection An interface representing a 

AuditEventElement collection 

lAuditEventElementEnumerator interface representing a class for 

enumerating a AuditEventElement 
collection 

lEqualitvComparer 

IHistorvDownloadCollection An interface representing a 

HistoryDownload collection 
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IHistoryDownloadEnumerator 

IHistorvElementCollection 

IHistorvElementEnumerator 

IHistoryVisitCollection 

IHi story Vi sitEnumerator 

IThumbnailCacheCollection 

IThumbnailCacheEnumerator 



interface representing a class for 
enumerating a HistoryDownload 
collection 

An interface representing a 
HistoryElement collection 

interface representing a class for 
enumerating a HistoryElement collection 

An interface representing a HistoryVisit 
collection 

interface representing a class for 
enumerating a HistoryVisit collection 
An interface representing a 
ThumbnailCache collection 
interface representing a class for 
enumerating a ThumbnailCache 
collection 



IUsagePattemEntryCol lection An interface representing a 

UsagePattemEntry collection 

IUsagePatternEntryEnumerator interface representing a class for 

enumerating a UsagePattemEntry 
collection 



Svstem.Storage.ExDlorerJnterop 

The following table lists examples of members exposed by the 
System.Storage.Explorer.Interop namespace. 

Interfaces 

IAuditEvent 
IAuditEventElement 
1 History 

IHi stor vDo wnl oad 

IHistorvElement 

IHistoryVisit 

IlnternetShortcut 

IShare 
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IThumbnail 

IThumbnailCache 

IUsagePattern UsagePattem item is type of folder that contains 

usage pattern entries. It also contains max number of 
entries. 

lUsagePatternEntry Link to item that is remembered in usage pattern. 

Also contains deep copy of property that is being 
remembered. 



Svstem.Storage.F ax 

The following tables list examples of members exposed by the 
System.Storage.Fax namespace. 

Classes 

FaxAccount 

FaxAccountProperties 

FaxAccountPropertlesCollection 

FaxAccountPropertiesEnumerator 

FaxAccountPropertiesHolder 

FaxAccountServer 

FaxAccountServerCollection 

FaxAccountServerEnumerator 

FaxAccountServerHolder 

FaxCoverPagelnfo 

FaxCoverPagelnfoCollection 

FaxCoverPagelnfoEnumerator 

FaxCoverPagelnfoHolder 

FaxFolder 

FaxMessage 

FaxParticipant 

FaxParticipantCollection 

FaxParticipantEnumerator 

Fax ParticipantHolder 

TransmissionDetails 
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Transmission DetailsCollection 

TransmissionDetailsEnumerator 

TransmissionDetailsHolder 

Interfaces 

IFaxAccountPropertiesCollection 

IFaxAccountPropertiesEnumerator 

IFaxAccountServerCollection 

IF ax AccountServerEnumerator 

IFaxCoverPagelnfoCollection 

IFaxCoverPagelnfoEnumerator 

IF ax Parti cipantCollection 

IF axParticipantEnumerator 

ITransmissionDetailsCollection 

ITransmissionDetailsEnumerator 

Svstem.Storage.Fax.Interop 

The following table lists examples of members exposed by the 
System. Storage .Fax. Interop namespace . 

Interfaces 

IFaxAccount 

IFaxAccountProperties 

IF ax AccountServer 

IFaxCoverPagelnfo 

IFaxFolder 

IFaxMessage 

IFaxParticipant 

IT ransniissionDetails 



lee@hayes poc 50^-324-9 2se 



71 



MS 1-1 793USAPP 







Svstem.Storage.Files 



The following table lists examples of members exposed by the 
System. Storage.Files namespace. 

Classes 

File File type encapsulates the metadata/properties of files. 



Svstem.Storage.Files.Interop 

The following table lists examples of members exposed by the 
System. Storage.F iles.Interop namespace. 

Interfaces 

IFile File type encapsulates the metadata/properties of files. 



Svstem.Storage.GameLibrarv 

The following table lists examples of members exposed by the 
System. Storage.GameLibrary namespace. 

Classes 

GameDesciiption The GameDescription type describes the metadata that is 
retrieved and stored from a game description file (GDF) 



Svstem.Storage.GameLibrarv.Interop 

The following table lists examples of members exposed by the 
System. Storage.GameLibrary .Interop namespace. 
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Interfaces 



IGameDescription The GameDescription type describes the metadata that 
is retrieved and stored from a game description file 
(GDF) 



Svstem.Storage.Help 

The following tables list examples of members exposed by the 
System.Storage.Help namespace. 

Classes 



Bundle 


A Bundle is a virtual 
collection of Help Topics. It 
is uniquely identified by the 
Name inside the current 
product. Each Topic inside a 
Bundle is uniquely identified 
by its partial Url (SubUrl). 


BundleCollection 


A Bundle collection 


BundleEnumerator 


A class for enumerating a 
Bundle collection 


BundleHolder 


a class to hold Bundle objects 


HeloFile 


A HelpFile is a physical file 
that contains Help Topics. 



HelpFileT opicLinkRel ationship 
HelpFileTopicLinkRelationshipCollection 



Product 


The top-level owner of all 
Help Bundles and HelpFiles. 
It maps to the Help content of 
real products. 


ProductHelpFileLinkRelationship 

ProductHelpFileLinkRelationshipCollection 




Topic 


A Topic is a Help primitive 
that the user can search on 




and view the content. 
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Interfaces 



IBundleCollectioii An interface representing a Bundle collection 

IBundl eEnumerator interface representing a class for enumerating a 
Bundle collection 



Svstem.Storage.Help.Interop 

The following table lists examples of members exposed by the 
System. Storage .Help . Interop name space . 

Interfaces 

IBundle A Bundle is a virtual collection of Help Topics. It is uniquely 
identified by the Name inside the current product. Each Topic 
inside a Bundle is uniquely identified by its partial Url (SubUrl). 

IHelpFile A HelpFile is a physical file that contains Help Topics. 

IProduct The top-level owner of all Help Bundles and HelpFiles. It maps 
to the Help content of real products. 

ITopic A Topic is a Help primitive that the user can search on and view 
the content. 



Svstem.Storage.Image 

The following table lists examples of members exposed by the 
System. Storage. Image namespace. 



Classes 

AnalvsisProperties A set of properties that are calculated on 

the photo by an analysis application. This 
extension should be applied to the Image 
items that have been passes through the 
analysis application. These properties are 
more of a cache, but they are expensive to 
recompute. These fields are application 
specific. Other applications may not 
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understand the internal format of these 
fields. 



AnalysisPropertiesCollection A AnalysisProperties collection 

AnalysisPropertiesEnumerator A class for enumerating a 

AnalysisProperties collection 

AnalysisPropertiesHolder a class to hold AnalysisProperties objects 

EventReference EventReference type represents a link to an 

Event Item. It may be dangling, in which 
case the fields on this type specify the 
name of the event. 



EventReferenceCollection 

EventReferenceEnumerator 



EventReferenceHolder 

Image 

LocationReference 



A EventReference collection 

A class for enumerating a EventReference 
collection 

a class to hold EventReference objects 

LocationReference type represents a link to 
a Location item. It may be dangling, in 
which case the fields on this type specify 
the location coordinates. 



LocationReferenceCollection A LocationReference collection 

LocationReferenceEnumerator A class for enumerating a 

LocationReference collection 



LocationReferenceHolder 

PersonReferenee 



PersonReferenceCollection 
Person Re ferenceEnumerator 



a class to hold LocationReference objects 

PersonReferenee type represents a link to a 
Contact Item. It may be dangling, in which 
case the fields on this type specify the 
name of the person. 

A PersonReferenee collection 

A class for enumerating a PersonReferenee 

collection 



PersonReferenceHolder 

Photo 



Region 

RegionCollection 

RegionEnumerator 

Re gionH older 
RegionOflnterest 



a class to hold PersonReferenee objects 

A set of properties describing a Photo if the 
picture is actually a Photograph. 

This type represents a region in an Image. 

A Region collection 

A class for enumerating a Region 
collection 

a class to hold Region objects 
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RegionOflnterestCol lection 
RegionOflnterestEnumerator 

RegionOflnterestHolder 



A RegionOflnterest collection 

A class for enumerating a RegionOflnterest 
collection 

a class to hold RegionOflnterest objects 



Interfaces 

IAnalysisPropertiesCollection An interface representing a 

AnalysisProperties collection 

lAnalysisPropertiesEnumerator interface representing a class for 

enumerating a AnalysisProperties 
collection 

IEventReferenceCollection An interface representing a 

EventReference collection 



IEventReferenceEnumerator interface representing a class for 

enumerating a EventReference collection 
ILocationReferenceCollection An interface representing a 

LocationReference collection 



ILocationReferenceEnumerator interface representing a class for 

enumerating a LocationReference 
collection 



IPersonReferenceCollection 



IPersonReferenceEnumerator 



IRegionCollection 



An interface representing a 
PersonReference collection 
interface representing a class for 
enumerating a PersonReference collection 
An interface representing a Region 
collection 



IRegionEnumerator 

IRegionOflnterestCollection 

IRegionOflnterestEnumerator 



interface representing a class for 
enumerating a Region collection 

An interface representing a 
RegionOflnterest collection 

interface representing a class for 
enumerating a RegionOflnterest collection 
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1 Svstem.Storage.Image.Interop 

2 The following table lists examples of members exposed by the 

3 System.Storage.Image.Interop namespace. 
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Interfaces 

IAnalysisProperties A set of properties that are calculated on the photo by 
an analysis application. This extension should be 
applied to the Image items that have been passes 
through the analysis application. These properties are 
more of a cache, but they are expensive to recompute. 
These fields are application specific. Other 
applications may not understand the internal format of 
these fields. 

IEventReference EventReference type represents a link to an Event 
Item. It may be dangling, in which case the fields on 
this type specify the name of the event. 

Ilmage This is a base type that is shared by all Images. It 

contains fields that describe image in general and are 
applicable to images stored in different formats. 

ILocati onReference LocationReference type represents a link to a 

Location item. It may be dangling, in which case the 
fields on this type specify the location coordinates. 

IPersonReference PersonReference type represents a link to a Contact 
Item. It may be dangling, in which case the fields on 
this type specify the name of the person. 

IPhoto A set of properties describing a Photo if the picture is 

actually a Photograph. 

IRegion This type represents a region in an Image. 

IRegionOflnterest 



Svstem.Storage.Interop 

The following tables list examples of members exposed by the 
System. Storage. Interop namespace . 
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Classes 



Convert Summary description for Convert. 



3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



Interfaces 



ICategoryRef 


A Category reference Identity key. Every 
categoryNode has an identity key of type 
CategoryRef. When category refences are 
tagged onto an item, they are tagged as a 
link type where the Link.Target contains a 
CategoryRef. 


Extension 


This is the type used as the basis for 
extensions. To establish an extension a new 




subtype of this type is defined. The 
extension may be added to an Item by 
creating an instance of the type and 
assigning it to the Extensions field of the 
Item to be extended. 


IExtensionCustom 

IFolder 

IldentitvKev 

litem 


Custom methods for the Extension class 


IltemContext 


This interface exposes methods on the 
COM Callerable Wrapper for the 
ItemContext class used in COM interop. 


IltemCustom 


Custom methods and properties for the 
Item object 


IltemName 


ItemName represents the path name of an 
item 


IltemNameCollection 


An ItemNameCollection contains all the 
item names for an item 


I ItemName En umerator 


interface representing a class for 
enumerating a ItemName collection 


ILink 

INestedElement 
IProiection Option 


This interface defines methods of the COM 
Callerable Wrapper for the 
ProjectionOption class used in the COM 
interop. 
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IQuery 



This interface exposes methods on the 
COM Callerable Wrapper for the Query 
class used in COM interop. 



IRecvcleBinLink 

[Search Projection This interface defines the methods for the 

COM Callerable Wrapper, 
SearchProjection, used in the COM interop. 

I S hare 

IStorageExceptionlnformation 
IStore 
I Volume 



Svstem.Storage.Image 

The following tables list examples of members exposed by the 
System.Storage.Image namespace. 



Classes 

AnalysisProperties A set of properties that are calculated on 

the photo by an analysis application. This 
extension should be applied to the Image 
items that have been passes through the 
analysis application. These properties are 
more of a cache, but they are expensive to 
recompute. These fields are application 
specific. Other applications may not 
understand the internal format of these 
fields. 



AnalvsisPropertiesCollection A AnalysisProperties collection 

AnalvsisPropertiesEnumerator A class for enumerating a 

AnalysisProperties collection 

AnalvsisPropertiesHolder a class to hold AnalysisProperties objects 

EventReference EventReference type represents a link to 

an Event Item. It may be dangling, in 
which case the fields on this type specify 
the name of the event. 
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EventReferenceCollection 



A EventReference collection 



EventReference Enumerator 



EventReferenceHolder 

Image 

LocationReference 



LocationReferenceCollection 

LocationReferenceEnumerator 



LocationReferenceHolder 

PersonReference 



PersonReferenceCollection 

PersonReferenceEnumerator 



PersonReferenceHolder 

Photo 



Region 

RegionCollection 

RegionEnumerator 

RegionHolder 

RegionOflnterest 

RegionOflnterestCollection 

RegionOflnterestEnumerator 

RegionOflnterestHolder 



A class for enumerating a 
EventReference collection 

a class to hold EventReference objects 



LocationReference type represents a link 
to a Location item. It may be dangling, in 
which case the fields on this type specify 
the location coordinates. 

A LocationReference collection 

A class for enumerating a 
LocationReference collection 

a class to hold LocationReference objects 

PersonReference type represents a link to 
a Contact Item. It may be dangling, in 
which case the fields on this type specify 
the name of the person. 

A PersonReference collection 

A class for enumerating a 
PersonReference collection 

a class to hold PersonReference objects 

A set of properties describing a Photo if 
the picture is actually a Photograph. 

This type represents a region in an Image. 

A Region collection 

A class for enumerating a Region 
collection 

a class to hold Region objects 



A RegionOflnterest collection 

A class for enumerating a 
RegionOflnterest collection 

a class to hold RegionOflnterest objects 
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IAnalvsisPropertiesCollection 


An interface representing a 
AnalysisProperties collection 


I Anal vsi sProperti e sEnum erator 


interface representing a class for 
enumerating a AnalysisProperties 
collection 


IEventReferenceCollection 


An interface representing a 
EventReference collection 


IEventReferenceEnumerator 


interface representing a class for 
enumerating a EventReference collection 


ILocationReferenceCollection 


An interface representing a 
LocationReference collection 


ILocationReferenceEnumerator 


interface representing a class for 
enumerating a LocationReference 
collection 


IPersonReferenceCollection 


An interface representing a 
PersonReference collection 


I Person ReferenceEnum erator 


interface representing a class for 
enumerating a PersonReference 
collection 


IRegionCollection 


An interface representing a Region 
collection 


I RegionEnumerator 


interface representing a class for 
enumerating a Region collection 


IRegionOflnterestCollection 


An interface representing a 
RegionOflnterest collection 


IRegionOflnterestEnumerator 


interface representing a class for 
enumerating a RegionOflnterest 
collection 
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1 Svstem.StorageJmage.Interop 

2 The following table lists examples of members exposed by the 

3 System.Storage. Image. Interop namespace. 
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Interfaces 



I An alvsis Properties A set of properties that are calculated on the photo by 

an analysis application. This extension should be 
applied to the Image items that have been passes 
through the analysis application. These properties are 
more of a cache, but they are expensive to recompute. 
These fields are application specific. Other 
applications may not understand the internal format 
of these fields. 



lEventReference EventReference type represents a link to an Event 

Item. It may be dangling, in which case the fields on 
this type specify the name of the event. 

Ilmage This is a base type that is shared by all Images. It 

contains fields that describe image in general and are 
applicable to images stored in different formats. 

ILocationReference LocationReference type represents a link to a 

Location item. It may be dangling, in which case the 
fields on this type specify the location coordinates. 

IPersonReference PersonReference type represents a link to a Contact 

Item. It may be dangling, in which case the fields on 
this type specify the name of the person. 

IPhoto A set of properties describing a Photo if the picture is 

actually a Photograph. 

1 Region This type represents a region in an Image. 

IRegionOflnterest 
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Svstem.Storage.Interop 

The following tables list examples of members exposed by the 
System. Storage. Interop namespace. 



Iee@hayes p«c 



509*324 *9 2S6 



82 



MS 1- 1 793USAPP 



1 



Classes 



2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



Convert Summary description for Convert. 



Interfaces 




ICategorvRef 


A Category reference Identity key. Every 
categoryNode has an identity key of type 
CategoryRef. When category refences are 
tagged onto an item, they are tagged as a 
link type where the Link.Target contains a 
CategoryRef. 


IExtension 


This is the type used as the basis for 
extensions. To establish an extension a 
new subtype of this type is defined. The 
extension may be added to an Item by 
creating an instance of the type and 
assigning it to the Extensions field of the 
Item to be extended. 


IExtensionCustom 

IFolder 

IldentitvKev 

litem 


Custom methods for the Extension class 


IltemContext 


This interface exposes methods on the 
COM Callerable Wrapper for the 
ItemContext class used in COM interop. 


IltemCustom 


Custom methods and properties for the 
Item object 


UtemName 


ItemName represents the path name of an 
item 


IltemNameCollection 


An ItemNameCollection contains all the 
item names for an item 


IltemNameEnumerator 


interface representing a class for 
enumerating a ItemName collection 


ILink 




INestedElement 




IProiectionOption 


This interface defines methods of the COM 
Callerable Wrapper for the 
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Projection Option class used in the COM 
interop. 

This interface exposes methods on the 
COM Callerable Wrapper for the Query 
class used in COM interop. 

This interface defines the methods for the 
COM Callerable Wrapper, 
SearchProjection, used in the COM 
interop. 



IStorageExceptionln formation 



IStore 



I Volume 



Svstem.Storage.Location 



The following tables list examples of members exposed by the 
System. Storage.Location namespace. 



Classes 

Address 



Angle3D 




Address represents an address for 
contacting a Contact via postal mail, or an 
indoor/outdoor location in the Location 
object. 

Angle3D represents a one-element, two- 
element, or three-element vector of angle 
values. The elements are of type float or 
NULL (corresponding to CLR double and 
NaN, respectively). The angle vector may 
be used to represent data like bearing (1- 
D), spherical coordinates (2-D), or (roll, 
pitch, yaw) values (3-D). 

A Angle3D collection 

A class for enumerating a Angle3D 
collection 
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Ang1e3DHolder a class to hold Angle3D objects 

CoordinateReferenceSvstem CoordinateReferenceSystem is used to 

explicitly identify the coordinate reference 
system and datum that is used. In nearly 
all cases, MS applications and 
implementations will standardize on 
WGS84 datum, geographic projection, 
decimal degree coordinate representations 
as the basis for transferring locations 
between applications. Internally, other 
coordinate systems could be used for 
performance reasons and graphic 
representations will almost certainly use a 
different projection and perhaps different 
units. The CoordinateReferenceSystem 
type has been designed to match the 
current LIF MLP 3.0 encoding for 
WGS84. Note that for an engineering 
coordinate system (such as a floor of a 
building), the Code, CodeSpace, and 
Edition indicate an "unknown" coordinate 
system. In this case, the 
EngineeringReference field is used to link 
to an EntityReference for the entity that 
defines the coordinate system. For 
example, a floor of a building has an 
EntityReference and a 
CoordinateReferenceSystem. Each 
Position defined on that floor will specify 
as its CoordinateSystem a link to the 
CoordinateReferenceSystem for the floor. 

EngineeringRefsEntitvRelations 

hip 

EngineeringRefsEntitvRelations 

hipCollection 

EntityReference This represents a reference to an entity. 

An entity is a place (continent, country, 
city, neighborhood, river, etc...) or space 
(building, floor, room, parking spot, 
cubicle) that is uniquely identified within 
a named data source. For example, 
MapPoint provides the definitions for 
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12 
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14 

15 

16 Matrix3x3 

17 

18 Matrix3x3 Collection 

, 9 Matrix3x3Enumerator 

20 Matrix3x3Ho1der 

21 NamedLocation 

22 




certain data source. Within the North 
America data source, the Space Needle is 
"1424488", Texas is "33145", and 
postcode 98007 is "154012087". In order 
to have the entity identifiers make sense, 
they are related to the data source provider 
at http://www.microsoft.com/MapPoint. 
There are hierarchies of Entities, such as 
City — > Admin 1 — > Country; or Building 
--> Floor — > Room. 

This is used to provide information about 
an 802. 1 1 access point, including it’s 
MAC address and signal strength (RSSI). 

Location Profile describes a set of location 
elements that pertains to a location. It has 
a userlD, an application ID, a context and 
a relationship to the Core.Location item (a 
collection of location elements). A profile 
may be created because an application 
running in a particular user context cares 
about a location and wants to be notified 
when the user reaches that location. A 
profile may just be transient in the sense 
that it was created by the location service 
on behalf of the user and cached in 
"WinFS". 

Matrix3x3 represents a 3x3 matrix of 
floats. Any of the matrix elements may be 
NULL. 

A Matrix3x3 collection 

A class for enumerating a Matrix3x3 
collection 

a class to hold Matrix3x3 objects 

Represents a user-inputted friendly name 
that can be associated with a location. The 
value is stored in the Item.DisplayName. 

A wrapper around scalar string to support 
multi-valued strings. 

ANonScalarStringl024 collection 

A class for enumerating a 
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or NonScalarStringl024 collection 

NonScalarStringl 024Holder a class to hold NonScalarStringl024 

objects 

ParentRelationship 

ParentRelationshipCollection 

Position This is used to provide position 

information. 



Position3D Position3D represents a one-element, two- 

element, or three-element vector of (x,y,z) 
position values. The elements are of type 
float or NULL (corresponding to CLR 
double and NaN, respectively). 

Position3DCollection A Position3D collection 



Position3DEnumerator A class for enumerating a Position3D 

collection 



Position3DHolder a class to hold Position3D objects 

PositionsCoordlnateSvstemRela 

tionship 

PositionsCoordinateSvstemRela 

tionshipCollection 

PositionUncertainty Abstract type to represent types of 

position uncertainty. 

PositionUncertaintvCollection A PositionUncertainty collection 



PositionUncertaintvEnumerator A class for enumerating a 

PositionUncertainty collection 



PosltionUncertaintvHolder a class to hold PositionUncertainty objects 



ProfileLocationRelationship 

ProfileLocationRelationshipCol 

lection 



SimpleUncertainty 

SimpleUncertaintvCol lection 
SimpleUncertaintvEnumerator 

SimpleUncertaintvHolder 

StatisticalUncertaintv 



Simple uncertainty represents uncertainty 
as a single value. 

A SimpleUncertainty collection 

A class for enumerating a 
SimpleUncertainty collection 

a class to hold SimpleUncertainty objects 

The uncertainty in (x,y,z) is represented 
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by a 3x3 covariance matrix. The main 
diagonal of the matrix, c[0][0], c[l][l], 
and c[2][2], represents the statistical 
variances of x, y, and z respectively. A 
variance is the square of the standard 
deviation. The off-diagonal elements 
represent the covariance of different 
pairings of x, y, and z. Mathematically the 
covariance matrix represents the expected 
deviations (dx,dy,dz) from a position. The 
covariance matrix specifically gives the 
expected values of the products of the 
deviations: [ c[0][0] c[0][l] c[0][2] ] [ 
c[l][0] c[l][l] c[l][2] ] [ c[2][0] c[2][l] 
c[2][2] ] [ E[dx*dx] E[dx*dy] E[dx*dz] ] 

[ E[dx*dy] E[dy*dy] E[dy*dz] ] [ 
E[dx*dz] E[dy*dz] E[dz*dz] ] where E[ ... 
] means expected value. Note that the 
covariance matrix is symmetric around the 
main diagonal. 

StatisticalUncertaintvCollection A StatisticalUncertainty collection 

Statistical Un certaintyEnumerat A class for enumerating a 

or StatisticalUncertainty collection 

Statistical UncertaintyHolder a class to hold StatisticalUncertainty 

objects 

Interfaces 

IAngle3DCollection An interface representing a Angle3D 

collection 

I An gle3DEnumerator interface representing a class for 

enumerating a Angle3D collection 

IMatrix3x3Collection An interface representing a Matrix3x3 

collection 

lMatrix3x3Enumerator interface representing a class for 

enumerating a Matrix3x3 collection 

INonScalar String 1 024Collectlon An interface representing a 

NonScalarStringl024 collection 

INonScalarString 1 024Enumerator interface representing a class for 

enumerating a NonScalarStringl024 



lee@hayes p«c 509-3244256 



88 



MS 1- 1793US.APP 




collection 



rPosition3DCollection 



An interface representing a Position3D 
collection 



rPosition3DEnumerator 

IPositionUncertaintvCollection 

IPositionUncertaintvEnumerator 

ISimpleUncertaintyCollectlon 

ISimpleUncertaintvEnumerator 



interface representing a class for 
enumerating a Position3D collection 

An interface representing a 
PositionUncertainty collection 

interface representing a class for 
enumerating a PositionUncertainty 
collection 

An interface representing a 
SimpleUncertainty collection 

interface representing a class for 
enumerating a SimpleUncertainty 
collection 



IStatisticalUncertaintvCollection An interface representing a 

StatisticalUncertainty collection 

IStatisticalUncertaintyEnumerator interface representing a class for 

enumerating a StatisticalUncertainty 
collection 



Svstem.Storage.Location.Interop 

The following table lists examples of members exposed by the 
System. Storage .Location . Interop namespace. 



Interfaces 

IAddress 



IAngle3D 



Address represents an address for contacting 
a Contact via postal mail, or an 
indoor/outdoor location in the Location 
object. 

Angle3D represents a one-element, two- 
element, or three-element vector of angle 
values. The elements are of type float or 
NULL (corresponding to CLR double and 
NaN, respectively). The angle vector may be 
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used to represent data like bearing (1-D), 
spherical coordinates (2-D), or (roll, pitch, 
yaw) values (3-D). 

ICoordinateReferenceSvstem CoordinateReference System is used to 

explicitly identify the coordinate reference 
system and datum that is used. In nearly all 
cases, MS applications and implementations 
will standardize on WGS84 datum, 
geographic projection, decimal degree 
coordinate representations as the basis for 
transferring locations between applications. 
Internally, other coordinate systems could be 
used for performance reasons and graphic 
representations will almost certainly use a 
different projection and perhaps different 
units. The CoordinateReferenceSystem type 
has been designed to match the current LIF 
MLP 3.0 encoding for WGS84. Note that for 
an engineering coordinate system (such as a 
floor of a building), the Code, CodeSpace, 
and Edition indicate an "unknown" 
coordinate system. In this case, the 
EngineeringReference field is used to link to 
an EntityReference for the entity that defines 
the coordinate system. For example, a floor 
of a building has an EntityReference and a 
CoordinateReferenceSystem. Each Position 
defined on that floor will specify as its 
Coordinate System a link to the 
CoordinateReferenceSystem for the floor. 

I EntityReference This represents a reference to an entity. An 

entity is a place (continent, country, city, 
neighborhood, river, etc...) or space 
(building, floor, room, parking spot, cubicle) 
that is uniquely identified within a named 
data source. For example, MapPoint provides 
the definitions for certain data source. Within 
the North America data source, the Space 
Needle is "1424488", Texas is "33145", and 
postcode 98007 is "154012087". In order to 
have the entity identifiers make sense, they 
are related to the data source provider at 
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Ileee802dotl 1 
ILocationProfile 



IMatrix3x3 

INamedLocation 

INonScalarString 1 024 

IPosition 

IPosition3D 



IPositionUnceitainty 

ISimpleUncertainty 

IStatisticalUncertainty 



http://www.microsoft.com/MapPoint. There 
are hierarchies of Entities, such as City — > 
Admin 1 --> Country; or Building — > Floor — 
> Room. 

This is used to provide information about an 
802. 1 1 access point, including it's MAC 
address and signal strength (RSSI). 

Location Profile describes a set of location 
elements that pertains to a location. It has a 
userlD, an application ID, a context and a 
relationship to the Core.Location item (a 
collection of location elements). A profile 
may be created because an application 
running in a particular user context cares 
about a location and wants to be notified 
when the user reaches that location. A profile 
may just be transient in the sense that it was 
created by the location service on behalf of 
the user and cached in "WinFS". 

Matrix3x3 represents a 3x3 matrix of floats. 
Any of the matrix elements may be NULL. 

Represents a user-inputted friendly name that 
can be associated with a location. The value 
is stored in the Item.DisplayName. 

A wrapper around scalar string to support 
multi-valued strings. 

This is used to provide position information. 

Position3D represents a one-element, two- 
element, or three-element vector of (x,y,z) 
position values. The elements are of type 
float or NULL (corresponding to CLR 
double and NaN, respectively). 

Abstract type to represent types of position 
uncertainty. 

Simple uncertainty represents uncertainty as 
a single value. 

The uncertainty in (x,y,z) is represented by a 
3x3 covariance matrix. The main diagonal of 
the matrix, c[0][0], c[l][l], and c[2][2], 
represents the statistical variances of x, y, 
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and z respectively. A variance is the square 
of the standard deviation. The off-diagonal 
elements represent the covariance of different 
pairings of x, y, and z. Mathematically the 
covariance matrix represents the expected 
deviations (dx,dy,dz) from a position. The 
covariance matrix specifically gives the 
expected values of the products of the 
deviations: [ c[0][0] c[0][l] c[0][2] ] [ c[l][0] 
c[l][l]c[l][2]][c[2][0] c[2][l] c[2][2] ] [ 
E[dx*dx] E[dx*dy] E[dx*dz] ] [ E[dx*dy] 
E[dy*dy] E[dy*dz] ] [ E[dx*dz] E[dy*dz] 
E[dz*dz] ] where E[ ... ] means expected 
value. Note that the covariance matrix is 
symmetric around the main diagonal. 



Svstem.Storage.Mai! 

The following table lists examples of members exposed by the 
System. Storage.Mail namespace. 

Classes 

ArticleRange 

Folder 

Message 



Svstem.Storage.Mail.Interop 

The following table lists examples of members exposed by the 
System. Storage. Mail. Interop namespace. 
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Interfaces 



IMessage 



Svstem.Storage.Media 

The following tables list examples of members exposed by the 
System. Storage. Media namespace. 



Classes 

CategoryRef 

CategorvRefCollection 

CategoryRefEnumerator 

CategoryRefHolder 

CustomRating 



CustomRatingCollection 

CustomRatingEnumerator 

CustomRatingHolder 

Distributor 



DistributorCollection 
Di stributorEnumerator 



Di stributorH older 
Document 



Temporary placeholder category reference 
type 

A CategoryRef collection 

A class for enumerating a CategoryRef 
collection 

a class to hold CategoryRef objects 

CustomRating type represents a free-form 
string rating given to the media document 
by some authority. 

A CustomRating collection 

A class for enumerating a CustomRating 
collection 

a class to hold CustomRating objects 

Distributor type represents a link to a 
Contact item for Content Distributor for 
Media information. May be dangling in 
which case the fields on this type specify 
the distributor. 

A Distributor collection 

A class for enumerating a Distributor 
collection 

a class to hold Distributor objects 

The type Media.Document represents 
audio documents such as tracks, albums, 
etc. It contains fields that are common for 
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all documents. 



History 



HistoryCollection 

HistorvEnumerator 



History type represents a history of this 
media document. When and how did I edit 
it? Who did i mail it to? Did I rotate it? 
Did I apply filters? 

A History collection 

A class for enumerating a History 
collection 



Hi story H older a class to hold History objects 

MetadataLi fecycle Metadata (lifecycle and other state 

tracking). 

MetadataLifecycleCollection A MetadataLifecycle collection 

MetadataLifecycleEnumerator A class for enumerating a 

MetadataLifecycle collection 

MetadataLi fecvcleHolder a class to hold MetadataLifecycle objects 



Rating 



RatingCollection 
Ratio gEnumerator 
RatingHolder 
StarRating 



Rating type represents a rating given to the 
media document by some authority. The 
authority cold be MPAA, Microsoft, or 
even myself. There are two types of 
ratings: string rating and numeric rating. 

To represent these cases people should 
create an instance of Custom rating or 
StarRating types. The Rating type itself 
doe s not contain the value of the rating, so 
it is an abstract type. 

A Rating collection 

A class for enumerating a Rating collection 
a class to hold Rating objects 

StarRating type represents a numeric rating 
given to the media document by some 
authority. 



StarRatingCollection A StarRating collection 



StarRatin gEnumerator A class for enumerating a StarRating 

collection 



StarRatin gHolder a class to hold StarRating objects 

UrlReference UrlReference type represents an URL 

together with a category that specifies what 
kind of URL is it. 
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UrlReferenceCollection A UrlReference collection 

U rlReferenceEnumerator A class for enumerating a UrlReference 

collection 

UrlReference Holder a class to hold UrlReference objects 



Interfaces 

ICategoryRefCollection 
I Cate gory Re fEnum erator 
ICustomRatlngCollection 
ICustomRatingEnumerator 
IDistributorCollectlon 



An interface representing a CategoryRef 
collection 

interface representing a class for 
enumerating a CategoryRef collection 

An interface representing a CustomRating 
collection 

interface representing a class for 
enumerating a CustomRating collection 

An interface representing a Distributor 
collection 



IDistributorEnumerator interface representing a class for 

enumerating a Distributor collection 

IHistorvCollection An interface representing a History 

collection 

IHi story Enumerator interface representing a class for 

enumerating a History collection 

IMetadataLifecycleCollection An interface representing a 

MetadataLifecycle collection 

IMetadataLifecycleEnumerator interface representing a class for 

enumerating a MetadataLifecycle 
collection 

An interface representing a Rating 
collection 

interface representing a class for 
enumerating a Rating collection 

An interface representing a StarRating 
collection 



IRatingCollection 

IRatingEnumerator 

IStarRatingCollection 



I StarRatin gEnumerator interface representing a class for 

enumerating a StarRating collection 

lUrlReferenceCollection An interface representing a UrlReference 
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collection 



fUrlReferenceEnumerator interface representing a class for 

enumerating a UrlReference collection 



Svstem.Storage.Media.Interop 

The following table lists examples of members exposed by the 
System.Storage.Media.Interop namespace. 



Interfaces 



ICategoryRef 

ICustomRating 



[Distributor 



Temporary placeholder category reference type 

CustomRating type represents a free-form string 
rating given to the media document by some 
authority. 

Distributor type represents a link to a Contact item for 
Content Distributor for Media information. May be 
dangling in which case the fields on this type specify 
the distributor. 



IDocument The type Media.Document represents audio 

documents such as tracks, albums, etc. It contains 
fields that are common for all documents. 



IHistorv History type represents a history of this media 

document. When and how did I edit it? Who did i 
mail it to? Did I rotate it? Did I apply filters? 

IMetadataLifecvcle Metadata (lifecycle and other state tracking). 



[Rating 



IStarRating 

[UrlReference 



Rating type represents a rating given to the media 
document by some authority. The authority cold be 
MPAA, Microsoft, or even myself. There are two 
types of ratings: string rating and numeric rating. To 
represent these cases people should create an instance 
of Custom rating or StarRating types. The Rating type 
itself doe s not contain the value of the rating, so it is 
an abstract type. 

StarRating type represents a numeric rating given to 
the media document by some authority. 

UrlReference type represents an URL together with a 
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Svstem.Storage.Meta 

The following tables list examples of members exposed by the 



System.Storage.Meta namespace. 

Classes 

BuiltlnField 

BuiltlnFieldCollection 

BuiltlnFieldEnumerator 



BuiltlnFieldHolder 

BulltlnTvpe 

ElementType 

Field 

FieldCollection 
F ieldEnumerator 
FieldHolder 
Index 

IndexCollection 
IndexEnumerator 
IndexField 
IndexFieldCollection 
IndexF iel dEnumerator 



IndexF ieldHolder 

IndexHolder 

NestedField 

NestedFieldCollection 

NestedFieldEnumerator 



A BuiltlnField collection 

A class for enumerating a BuiltlnField 
collection 

a class to hold BuiltlnField objects 



A Field collection 

A class for enumerating a Field collection 
a class to hold Field objects 

A Index collection 

A class for enumerating a Index collection 

A IndexField collection 

A class for enumerating a IndexField 
collection 

a class to hold IndexField objects 
a class to hold Index objects 

A NestedField collection 

A class for enumerating a NestedField 
collection 



lee@hayes pOc 509- 324.925a 



97 



MS 1- 1 793US.APP 




1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



NestedFieldHolder a class to hold NestedField objects 

ReferencedSchema 

ReferencedSchemaCollection A ReferencedSchema collection 

ReferencedSchemaEnumerator A class for enumerating a 

ReferencedSchema collection 

RcfcrencedSchemaHolder a class to hold ReferencedSchema objects 

Related Value 

RelatedValueCollection A RelatedValue collection 

Rel ated V alueEnumerator A class for enumerating a RelatedValue 

collection 



Rel ated V alueHolder 




RelationshipEnumerator 



a class to hold RelatedValue objects 

A Relationship collection 

A class for enumerating a Relationship 
collection 



Rel ationshipHolder a class to hold Relationship objects 

Schema 

Type 

View 



ViewCollection A View collection 

ViewEnumerator A class for enumerating a View collection 

ViewField 



ViewFieldCollection A ViewField collection 

ViewFieldEnumerator A class for enumerating a ViewField 

collection 



ViewFieldHolder a class to hold ViewField objects 

ViewHolder a class to hold View objects 



Interfaces 

IBuiltlnFieldCollection An interface representing a BuiltlnField 

collection 

IBuiltlnFieldEnumerator interface representing a class for 

enumerating a BuiltlnField collection 
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IFieldCollection 

lFieldEnumerator 

IlndexCollection 

IlndexEnumerator 

IindexFieldCollection 

rindexFieldEnumerator 

INestedFieldCollection 



An interface representing a Field 
collection 

interface representing a class for 
enumerating a Field collection 

An interface representing a Index 
collection 

interface representing a class for 
enumerating a Index collection 

An interface representing a IndexField 
collection 

interface representing a class for 
enumerating a IndexField collection 

An interface representing a NestedField 
collection 



INestedFieldEnumerator interface representing a class for 

enumerating a NestedField collection 

IReferencedSchemaCollection An interface representing a 

ReferencedSchema collection 



IReferencedSchemaEnumerator interface representing a class for 

enumerating a ReferencedSchema 
collection 

IRelatedValueCollection An interface representing a RelatedValue 

collection 



IRel atedV a 1 ueEnumerator 



IRelationshipCollection 

IRelationshipEnumerator 

IViewCollection 



interface representing a class for 
enumerating a RelatedValue collection 

An interface representing a Relationship 
collection 

interface representing a class for 
enumerating a Relationship collection 

An interface representing a View 
collection 



IView Enumerator 



IViewFieldCollection 



IViewFieldEnumerator 



interface representing a class for 
enumerating a View collection 

An interface representing a ViewField 
collection 

interface representing a class for 
enumerating a ViewField collection 
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Svstem.Storage.Meta.Interop 



The following table lists examples of members exposed by the 

System. Storage.Meta.Interop namespace. 

Interfaces 

IBuiltlnField 

IBuiltlnTvpe 

IElementType 

IField 

Ilndex 

HndexField 

INestedField 

IReferencedSchema 

IRelatedValue 

IRelationship 

ISchema 

IType 

I View 

IViewField 



Svstem.Storage.NaturalUI 

The following table lists examples of members exposed by the 
System. Storage.NaturalUI namespace. 

Classes 

Annotation Links the interpretations to annotations. It is used to 
decorate the interpretation with both State and Phrase 
annotations. 
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AnnotationTvpe Enumeration of different annotation types 

supported.Following are the valid set of Annotation 
types: 1. BestBetExact 2. BestBetpartial 3. BiasedDown 
4. BiasedUp 5. GeneratedBy 6. Required "Required" 
annotation type will implemented as a bias and biasedUp 
and biasedDown will also be implemented using 
biasedBy with positive/negative weights identifying 
each. 



Cluster A cluster is a grouping of locale and Annotati onSet. An 

AnnotationSet is a "partition" or application specific 
"string" that may be used to group logical data together 
and then selectively search over it. The concept of 
AnnotationSet followins from the NUIPEdit tool file 
format and it is the "basic unit of work". That is, the 
install process will work per AnnotationSet basis. 

Culture This is added to to support the internationalization 

feature. This entity serves dual purpose - along with 
storing all the languages supported by the Runtime 
Store, it also gives a mapping to the collations for each 
language which are used at runtime for matching query 
strings to phrase annotations based on rules such as 
accent or case sensitivity etc.. 

NamedEntitv Named Entities are strongly typed entities like email, url, 
datetime etc that are recognized by LSP. We need to 
store the fully qualified name of the named entity type 
that the NUI Runtime as well as LSP recognizes. 

Phrase Phrases that are used to annotate proxy and proxy classes 

(basically interpretations). This is what we call the 
phrase annotations. 

Phrase Word Stores the association of words to phrases that constitute 

that phrase. 



SerializedObiect From a Store stand point, the applications should be able 
to store any object and annotate it. The store needs to be 
as generic as possible. We don't have a hard requirement 
to recognize the structure of that data that is persisted. 
Therefore, we binary serialize the object or type instance 
and store it in a VARBINARY column. 



State Rule The state annotations are basically State Rule 

expressions that are authored by the NUI Authoring 
team. State rules will be created by developers as objects 
and stored in dlls. Along with Phrase, the fragments can 
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be decorated with state annotations. 



Type The CLR type of the object instance persisted. This table 

holds both the Outer as well as the Inner type names. 

Word This represents the words in a Phrase. Words are shared 

across Phrases and hence are stored uniquely. A word is 
stored as a string along with the CHECKSUM value of 
the string. And for fast retrievals, it is this checksum that 
is indexed instead of the actual string. 



Svstem.Storage.NaturalULInterop 

The following table lists examples of members exposed by the 
System.Storage.NaturalUI.Interop namespace. 

Interfaces 

I Annotation Links the interpretations to annotations. It is used to 
decorate the interpretation with both State and Phrase 
annotations. 

I AnnotationT vpe Enumeration of different annotation types 

supported. Following are the valid set of Annotation 
types: 1. BestBetExact 2. BestBetpartial 3. BiasedDown 
4. BiasedUp 5. GeneratedBy 6. Required "Required" 
annotation type will implemented as a bias and 
biasedUp and biasedDown will also be implemented 
using biasedBy with positive/negative weights 
identifying each. 

ICluster A cluster is a grouping of locale and AnnotationSet. An 

AnnotationSet is a "partition" or application specific 
"string" that may be used to group logical data together 
and then selectively search over it. The concept of 
AnnotationSet followins from the NUIPEdit tool file 
format and it is the "basic unit of work". That is, the 
install process will work per AnnotationSet basis. 

ICulture This is added to to support the internationalization 

feature. This entity serves dual purpose - along with 
storing all the languages supported by the Runtime 
Store, it also gives a mapping to the collations for each 
language which are used at runtime for matching query 
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strings to phrase annotations based on rules such as 
accent or case sensitivity etc.. 

1 Named Entity Named Entities are strongly typed entities like email, 

url, datetime etc that are recognized by LSP. We need to 
store the fully qualified name of the named entity type 
that the NUI Runtime as well as LSP recognizes. 

IPhrase Phrases that are used to annotate proxy and proxy 

classes (basically interpretations). This is what we call 
the phrase annotations. 

IPhraseWord Stores the association of words to phrases that constitute 
that phrase. 

ISerializedObiect From a Store stand point, the applications should be 

able to store any object and annotate it. The store needs 
to be as generic as possible. We don't have a hard 
requirement to recognize the structure of that data that 
is persisted. Therefore, we binary serialize the object or 
type instance and store it in a VARBINARY column. 

IStateRule The state annotations are basically State Rule 

expressions that are authored by the NUI Authoring 
team. State rules will be created by developers as 
objects and stored in dlls. Along with Phrase, the 
fragments can be decorated with state annotations. 

IType The CLR type of the object instance persisted. This 

table holds both the Outer as well as the Inner type 
names. 

I Word This represents the words in a Phrase. Words are shared 

across Phrases and hence are stored uniquely. A word is 
stored as a string along with the CHECKSUM value of 
the string. And for fast retrievals, it is this checksum 
that is indexed instead of the actual string. 



stem. Storage. Notes 



The following table lists examples of members exposed by the 



System.Storage.Notes namespace. 



lee @h a yes poc 509*324*9256 



103 



MSI- 1793US.APP 




Classes 



ImageTitle 

JournalNote 

Note 

StickyNote 



An image title for an item. 

A Windows Journal document. 
A base class for Notes. 

A Sticky Note. 



Svstem.Storage.Notes.Interop 

The following table lists examples of members exposed by the 
System.Storage.Notes.Interop namespace. 



Interfaces 

IlmageTitle 
I JournalNote 
INote 

IStickvNote 



An image title for an item. 

A Windows Journal document. 
A base class for Notes. 

A Sticky Note. 



Svstem.Storage.Notification 

The following table lists examples of members exposed by the 

System.Storage.Notification namespace. 

Classes 

Subscription 
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Svstem.Storage.Principal 

The following tables list examples of members exposed by the 



System.Storage.Principal namespace. 
Classes 

AccountCredentials 

AccountCredentialsCollection 

AccountCredentialsEnumerator 

AccountCredentialsHolder 

Accountlnformation 

AccountlnformationCollection 

AccountlnformationEnumerator 

AccountlnformationHolder 

Certificate 

CertificateCollection 
Certi ficateEnumerator 

CertificateHolder 

CreditCardldentity 

CreditCardldentitvClaim 

Emailldentitv 

EmailldentitvClaim 

Guidldentity 

GuidldentitvClaim 



Describes the account information 
related to user/device accounts. 

A AccountCredentials collection 

A class for enumerating a 
AccountCredentials collection 

a class to hold AccountCredentials 
objects 

This type holds the fields for user 
account credentials. 

A Accountlnformation collection 

A class for enumerating a 
Accountlnformation collection 

a class to hold Accountlnformation 
objects 

This type defines scheme attributes for 
storing a digital certificate, a X.509 
certificate for instance. 

A Certificate collection 

A class for enumerating a Certificate 
collection 

a class to hold Certificate objects 

An IdentityReference holding credit 
card information. 

An IdentityClaim holding credit card 
information. 

An IdentityReference containing an 
email address. 

An IdentityClaim containing an email 
address. 

An IdentityClaim containing a GUID. 



105 



MS 1- 1 793US.APP 




IdentityClaim 



IdentityClaimCollection 

IdentityClairnEnumerator 

IdentitvClaimHolder 

IdentityReference 

IdentityReferenceCollection 
Identity ReferenceEnumerator 

IdentityReferenceHolder 

LdapDNIdentitv 

LdapDNIdentitvClaim 

LegacvNT4Parameters 



LegacyNT4ParametersCollection 



An IdentityClaim is a value assigned 
by an authority of a given type to 
identify a single principal during a 
given period of time. Examples of 
IdentityClaims include RFC 822 e- 
mail addresses, E.164 telephone 
numbers, Microsoft security identifiers 
(SIDs), and LDAP GUIDs. 

A IdentityClaim collection 

A class for enumerating a 
IdentityClaim collection 

a class to hold IdentityClaim objects 

An IdentityReference is a reference to 
an IdentityClaim. 

A IdentityReference collection 

A class for enumerating a 
IdentityReference collection 

a class to hold IdentityReference 
objects 

An IdentityReference containing an 
LDAP Distinguished Name. 

An IdentityClaim containing an LDAP 
Distinguished Name. 

Things not relevant to "WinFS" 
Systems. AD has a number of 
parameters that they do not think are 
not used. However, they are not sure 
about what appcompat issues will 
ensue if they remove them completely; 
hence, they are hiding them under 
LegacyNTParameters. 

A LegacyNT4Parameters collection 



LegacvNT4ParametersEnumerator A class for enumerating a 

LegacyNT4Parameters collection 



LegacvNT4ParametersHolder a class to hold LegacyNT4Parameters 

objects 



Licenseldentltv An IdentityReference containing 

license information. 
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LicenseldentityClaim 

NonScalarString 1 024 
NonScalarStringl024Collection 
NonScalarString 1 024Enumerator 

NonScalarString 1 024Holder 

NT4AccountIdentity 

NT4AccountldentltyClaim 

P2PIdentitv 

P2PldentityClaim 

Principal 

PrincipalCollection 

PrincipalEnumerator 

PrincipalHolder 

PrincipalldentityKey 



PrincipalldentityKeyCollection 

PrincipalldentitvKevEnumerator 

PrincipalldentityKeyH older 

Securityldentity 

SecurityldentityClaim 

ServiceDelegationlnfo 

ServiceDelegationlnfoCollection 

ServiceDelegationlnfoEnumerator 



An IdentityClaim containing license 
information. 

A NonScalarString 1024 collection 

A class for enumerating a 
NonScalarString 1024 collection 

a class to hold NonScalarString 1024 
objects 

An IdentityReference containing P2P 
information. 

An IdentityClaim containing P2P 
information. 

A Principal is a security principal. It 
can authenticate its identity, access 
resources, etc. 

A Principal collection 

A class for enumerating a Principal 
collection 

a class to hold Principal objects 

This type is derived from Identity Key 
to provide support for signatures and 
time based identities keys (driver's 
licence, temporary accounts etc...). 

A PrincipalldentityKey collection 

A class for enumerating a 
PrincipalldentityKey collection 

a class to hold PrincipalldentityKey 
objects 

Securityldentity Class 
SecurityldentityClaim Class 

A ServiceDelegationlnfo collection 

A class for enumerating a 
ServiceDelegationlnfo collection 
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1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



S erviceDe 1 e gati on I n foHolder 

SignedNestedElement 

SignedNestedElementCollection 

SignedNestedElementEnumerator 

SignedNestedElementHolder 

Ssnldentitv 

S snldentit yClaitn 

Transitldentity 

TransitldentitvCl aim 

Unknown! dentity 
U nknownl dentitvClaim 
Upnldentity 

UpnldentityClai m 

Interfaces 

IAccountCredentialsCollection 

lAccountCredentialsEnumerator 

IAccountlnformationCollection 

lAccountlnformationEnumerator 

ICertificateCollection 

ICertificateEnumerator 



a class to hold ServiceDelegationlnfo 
objects 

A SignedNestedElement collection 

A class for enumerating a 
SignedNestedElement collection 

a class to hold SignedNestedElement 
objects 

An IdentityReference containing a 
Social Security Number. 

An IdentityClaim containing a Social 
Security Number. 

An IdentityReference containing 
routing information for a bank. 

An IdentityClaim containing routing 
information for a bank. 

An unknown IdentityReference. 

An unknown IdentityReference. 

An IdentityReference that contains a 
UPN. 

An IdentityClaim that contains a UPN. 



An interface representing a 
AccountCredentials collection 

interface representing a class for 
enumerating a AccountCredentials 
collection 

An interface representing a 
Accountlnformation collection 

interface representing a class for 
enumerating a Accountlnformation 
collection 

An interface representing a Certificate 
collection 

interface representing a class for 
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IldentitvClaimCollection 
Ildenti t vClaimEn umerator 

HdentityReferenceCollection 
Ildenti tv ReferenceEnumerator 

ILegacvNT4ParametersCollection 
ILe gac vNT 4ParametersEnumerator 

INonScalarString 1 024Co11ection 
INonScalarString 1 024Enumerator 

IPrincipalCollection 

IPrincipalEnumerator 

IPrincipalldentitvKeyCollection 

IPrincipalldentityKevEnumerator 

IServiceDelegationlnfoCollection 

IServiceDelegationlnfoEniimerator 

ISignedNestedElementCoUection 

ISignedNestedElementEnumerator 



enumerating a Certificate collection 

An interface representing a 
IdentityClaim collection 

interface representing a class for 
enumerating a IdentityClaim 
collection 

An interface representing a 
IdentityReference collection 

interface representing a class for 
enumerating a IdentityReference 
collection 

An interface representing a 
LegacyNT4Parameters collection 

interface representing a class for 
enumerating a LegacyNT4Parameters 
collection 

An interface representing a 
NonScalarStringl024 collection 

interface representing a class for 
enumerating a NonScalarStringl024 
collection 

An interface representing a Principal 
collection 

interface representing a class for 
enumerating a Principal collection 

An interface representing a 
PrincipalldentityKey collection 

interface representing a class for 
enumerating a PrincipalldentityKey 
collection 

An interface representing a 
ServiceDelegationlnfo collection 

interface representing a class for 
enumerating a ServiceDelegationlnfo 
collection 

An interface representing a 
SignedNestedElement collection 

interface representing a class for 
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1 



enumerating a SignedNestedElement 
collection 



2 

3 

4 

5 

6 
7 



Enumerations 

PasswordModifyMethod 

WellKnownSidT ype This enumeration contains all of the well known 

SID types. 



8 

9 

10 

11 

12 

13 

14 



Svstem.Storage.Principal.InteroD 

The following table lists examples of members exposed by the 
System.Storage.Principal.Interop namespace. 

Interfaces 

IAccountCredentials Describes the account information related to 

user/device accounts. 

lAccountlnformation This type holds the fields for user account 

credentials. 



15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 



ICertificate 



IldentitvClaim 



IldentityReference 



This type defines scheme attributes for storing a 
digital certificate, a X.509 certificate for instance. 

An IdentityClaim is a value assigned by an 
authority of a given type to identify a single 
principal during a given period of time. Examples 
of IdentityClaims include RFC 822 e-mail 
addresses, E.164 telephone numbers, Microsoft 
security identifiers (SIDs), and LDAP GUIDs. 

An IdentityReference is a reference to an 
IdentityClaim. 



ILegacvNT4Parameters Things not relevant to "WinFS" Systems. AD has 

a number of parameters that they do not think are 
not used. However, they are not sure about what 
appcompat issues will ensue if they remove them 
completely; hence, they are hiding them under 
LegacyNTParameters . 

INonScalarStringl 024 
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IPrincipal 



A Principal is a security principal. It can 
authenticate its identity, access resources, etc. 

IPri ncipalldentityKev This type is derived from Identity Key to provide 

support for signatures and time based identities 
keys (driver's licence, temporary accounts etc...). 

IServiceDelegationlnfo 

ISignedNestcdElement 



Svstem.Storage.Programs 

The following table lists examples of members exposed by the 
System.Storage.Programs namespace. 

Classes 

Program 



Svstem.Storage.Programs.Interop 

The following table lists examples of members exposed by the 
System . Storage .Programs .Interop namespace . 

Interfaces 

IProgram 



Svstem.Storage.Service 

The following table lists examples of members exposed by the 
System.Storage.Service namespace. 
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Classes 



A uthenticationService 



EndPoint 



EndPointCollection 

EndPointEnumerator 



EndPointH older 
IntElement 



IntElementCollection 

IntElementEnumerator 



Holds the attributes for 
AuthenticationService in the system. 

Each service can expose a number of 
service locations. These locations 
represent an association between the 
points of access for interacting with the 
service and the model or interface for 
manipulating the services available at 
that location. This class is consistent in 
nature with UDDI bindings and WSDL 
ports. The ELocation class currently 
exposed in the "WinFS" data model 
could potentially be useful in 
supporting this concept. The use of 
category and property information on 
this class will be considered secondary 
for the purposes of service location. 
This class will need to expose an 
overview document. This class will 
need to enforce referential integrity 
constraints between 
Binding, TechnicalModels and 
T echnicalModel .T echnicalModelKey 

A EndPoint collection 

A class for enumerating a EndPoint 
collection 

a class to hold EndPoint objects 

A wrapper to support multi-valued ints. 
Used in the AuthenticationService 
definition. 

A IntElement collection 

A class for enumerating a IntElement 
collection 



IntElementHolder 

LocalizedDescription 

LocalizedDescriptionCollection 

LocalizedDescriptionEnumerator 



a class to hold IntElement objects 

Holds language-specific descriptions of 
an entity. 

A LocalizedDescription collection 
A class for enumerating a 
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LocalizedDescriptionHolder 

LocalizedName 

LocalizedNameColIection 

LocalizedNameEnumerator 

LocalizedNameHolder 

Service 



ServiceProviderRelationship 

ServiceProviderRel ation shipColle 
ction 



LocalizedDescription collection 

a class to hold LocalizedDescription 
objects 

Holds language-specific names of an 
entity. 

A LocalizedName collection 



a class to hold LocalizedName objects 

Services are independent resources that 
can be manipulated through an 
electronic interface available at an 
identifiable location or address. 
Examples include web services and 
printing services. 



A class for enumerating a 
LocalizedName collection 



SyncService Sync item stores the sync profile 

information. For example, suppose we 
want to represent the AD service that 
sync's contact information. This would 
be represented as: Category = "Active 
Directory" Name = "redmond" (name 
of the forest/domain in which the 
contact resides) Last Sync, Last Sync 
Error, other sync-related parameters. 
Property Set = list of AD/"WinFS" 
properties to be sync'ed. An example of 
a property set might be phone number 
and office location, i.e., the schema 
designer can specify a partial sync 
rather than sync'ing down all the AD 
properties. 



Interfaces 

IEndPointCollection An interface representing a EndPoint 

collection 

lEndPoi ntEnumerator interface representing a class for 

enumerating a EndPoint collection 
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IlntElementCollection An interface representing a IntElement 

collection 

UntElementEnumerator interface representing a class for 

enumerating a IntElement collection 

ILocalizedDescriptionCollection An interface representing a 

LocalizedDescription collection 

ILocalizedDescriptionEnumerator interface representing a class for 

enumerating a LocalizedDescription 
collection 

ILocalizedNameCol lection An interface representing a 

LocalizedName collection 

ILocalizedNameEnumerator interface representing a class for 

enumerating a LocalizedName 
collection 



/stem.Storage.Service.Interoi 



The following table lists examples of members exposed by the 
System.Storage.Service.Interop namespace. 



Interfaces 

IAuthenticationService Holds the attributes for AuthenticationService in 

the system. 

lEndPoint Each service can expose a number of service 

locations. These locations represent an association 
between the points of access for interacting with 
the service and the model or interface for 
manipulating the services available at that 
location. This class is consistent in nature with 
UDDI bindings and WSDL ports. The ELocation 
class currently exposed in the "WinFS" data 
model could potentially be useful in supporting 
this concept. The use of category and property 
information on this class will be considered 
secondary for the purposes of service location. 
This class will need to expose an overview 
document. This class will need to enforce 
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referential integrity constraints between 
Binding, TechnicalModels and 
TechnicalModel.TechnicalModelKey 

llntElement A wrapper to support multi-valued ints. Used in 

the AuthenticationService definition. 

Holds language-specific descriptions of an entity. 

Holds language-specific names of an entity. 

Services are independent resources that can be 
manipulated through an electronic interface 
available at an identifiable location or address. 
Examples include web services and printing 
services. 

ISyncService Sync item stores the sync profile information. For 

example, suppose we want to represent the AD 
service that sync's contact information. This 
would be represented as: Category = "Active 
Directory" Name = "redmond" (name of the 
forest/domain in which the contact resides) Last 
Sync, Last Sync Error, other sync-related 
parameters. Property Set = list of AD/"WinFS" 
properties to be sync'ed. An example of a property 
set might be phone number and office location, 
i.e., the schema designer can specify a partial sync 
rather than sync'ing down all the AD properties. 



ILocalizedDescription 

ILocalizedName 

IService 



Svstem.Storage.ShellT ask 

The following tables list examples of members exposed by the 
System. Storage. ShellT ask namespace. 

Classes 

A pplication The top-level owner of Tasks 

and Implementations. 

Ap plicationExperienceRelationship 

ApplicationExperienceRelationshipCollect 

ion 

ApplicationlmplementationRelationship 
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A pplicationlmplementationRelationshipC 

ollection 

ApplicatiopManifestRelationship 

ApplicationManifestRelationshipCollectio 

p 



ApplicationTaskRelationship 

A pplicatiopTaskRelatiopshipCollectiop 

AttachmentsRelationship 



AttachrnentsRelationshipCollection 

AutomatedTask 

Category 

EntryPoint 

EntryPointCollection 

EntryPointEnumerator 

EntryPoiptHolder 

Experience 



ExperienceScopeLinkRelationship 



Ap AutopiatedTask is a task 
that does pot ipvolve huruap 
ipterveutiop such as priutipg a 
documeut. 

Categories are a user-browsable 
taxopomy coptainipg Tasks. 

Defines a way to lauuch code 
or browse to a page. 

A EptryPoipt collection 

A class for epumeratipg a 
EntryPoint collection 

a class to hold EntryPoint 
objects 

Experience describes the folder 
being browsed, file type 
selected, or other user 
experience during which a Task 
might appear. A Task is 
mapped to an Experience 
through a Scope. Examples of 
experience might be: 

'ShellT ask . InMyDocumentsFol 
der', 

'ShellTask.ImageFilesSelected', 
'ShellT ask. StartPage', etc. 



ExperienceScopeLinkRelationshipCollecti 

on 



ExtendsExperienceLinkRelationship 
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An entry point which can be 
launched as a result of a Task 
being clicked. 

Use this type to link items in a 
particular order. 

A OrderedLink collection 

A class for enumerating a 
OrderedLink collection 

a class to hold OrderedLink 
objects 

Scope defines in what 
Presentation a Task should 
appear during a certain 
Experience. A Task is mapped 
to an Experience through a 
Scope. Examples of Scopes 
might be: 'The Task Pane in the 
MyDocuments folder', 'The 
Context menu when an Image 
file is selected', etc. 

Used to link Scopes to an 
Experience. 

A ScopeLink collection 

A class for enumerating a 
ScopeLink collection 

a class to hold ScopeLink 
objects 



SubjectTerms are used as a 
user-browsable Index for 
Tasks. 

A Shell Task is a representation 
of something the system can do 
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TaskCategorvList 
TaskCategoryListCollection 
T askC ate goryLi stEnumerator 

TaskCategoryListHolder 



such as print a document, send 
a message or reconfigure the 
desktop. 

A TaskCategoryList collection 

A class for enumerating a 
TaskCategoryList collection 

a class to hold 
TaskCategoryList objects 

A 

T askCategoryT oplmplementati 
onList collection 

A class for enumerating a 
T askCategoryT oplmplementati 
onList collection 

a class to hold 

T askCategoryT oplmplementati 
onList objects 



T askCategoryT oplmpl ementationList 

TaskC ate goryT oplmplementati onLi stC oil 
ection 

TaskCategorvT opImplementationListEnu 
merator 

TaskCategorvTopImplementationListHold 

er 



TasklmplementationLinkRelationship 

TasklmplementationLinkRelationshipColl 

ection 

TasklmplementationList 

TasklmplementationListCollection A TasklmplementationList 

collection 



Tasklmpl ementationLi stEnumerator 



A class for enumerating a 
T asklmpl ementationLi st 
collection 



TasklmplementationListHolder a class to hold 

T asklmpl ementationLi st 
objects 

TaskScopelmplementati onList 

T askScopelmplementati onListCol lection A 

T askScopelmpl ementationList 
collection 



TaskScopelmplementationListEnumerator 



A class for enumerating a 

TaskScopelmplementationList 

collection 
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T askSco pelmpl ementationLi stHolder 

TaskScopeList 
TaskScopeListCol lection 
T askScopeListEnumerator 

TaskScopeListHolder 

TaskStateLinkRelationship 

TaskStateLinkRelationshipCollection 

TaskTopImplementationList 



T askT opl mpl ementatioiiListHolder 

WindowsUser 
WindowsUserCollection 
W ind o ws U serEnum erator 

WindowsUserHolder 



a class to hold 

TaskScopelmplementationList 

objects 

A TaskScopeList collection 

A class for enumerating a 
TaskScopeList collection 

a class to hold TaskScopeList 
objects 



A TaskTopImplementationList 
collection 

A class for enumerating a 
T askT opImplementationList 
collection 

a class to hold 

T askT opImplementationList 
objects 

A windows user. 

A WindowsUser collection 

A class for enumerating a 
WindowsUser collection 

a class to hold WindowsUser 
objects 



T askT oplmplementationListCollection 
TaskTopImplementationListEnumerator 



Interfaces 

IEntrvPointCollection 
lEntryPoi ntEnumerator 
lOrderedLinkCollection 
IOrderedLinkEnumerator 



An interface representing a 
EntryPoint collection 

interface representing a class for 
enumerating a EntryPoint collection 

An interface representing a 
OrderedLink collection 

interface representing a class for 
enumerating a OrderedLink 
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collection 



IScopeLinkCollection 

IScopeLinkEnumerator 

ITaskCategoryListCollection 

ITaskCategoryListEnumerator 

ITaskCategoryTopImpl.enientation.Li 

stCollection 

ITaskCategor vT opImplementationLi 
stEnumerator 

ITasklmplementationListCollection 

ITasklmplementationListEnumerator 

IT askScopelmplementationLi stColle 
ction 

ITaskScopelmplementationListEnum 

erator 

ITaskScopeListCollection 
ITaskScopeLi stEnumerator 

ITaskTopImplementationListCollecti 

on 

IT askT opImplementationLi stEnumer 
ator 



An interface representing a 
ScopeLink collection 

interface representing a class for 
enumerating a ScopeLink collection 

An interface representing a 
TaskCategoryList collection 

interface representing a class for 
enumerating a TaskCategoryList 
collection 

An interface representing a 
T askCategoryT opImplementationLis 
t collection 

interface representing a class for 
enumerating a 

T askCategoryT opImplementationLis 
t collection 

An interface representing a 
TasklmplementationList collection 

interface representing a class for 
enumerating a 

TasklmplementationList collection 

An interface representing a 
T askScopelmplementationList 
collection 

interface representing a class for 
enumerating a 

TaskScopelmplementationList 

collection 

An interface representing a 
TaskScopeList collection 

interface representing a class for 
enumerating a TaskScopeList 
collection 

An interface representing a 
T askT opImplementationList 
collection 

interface representing a class for 
enumerating a 
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I WindowsUserCol lection 



IWindowsUserEnumerator 



T askT opImplementationList 
collection 

An interface representing a 
WindowsUser collection 

interface representing a class for 
enumerating a WindowsUser 
collection 



Svstem.Storage.ShellTask.Interop 

The following table lists examples of members exposed by the 
System. Storage. ShellTask.Interop namespace. 

Interfaces 

IApplication The top-level owner of Tasks and 

Implementations. 

IAutomatedTask An AutomatedTask is a task that 

does not involve human 
intervention such as printing a 
document. 

Categories are a user-browsable 
taxonomy containing Tasks. 

Defines a way to launch code or 
browse to a page. 

Experience describes the folder 
being browsed, file type selected, 
or other user experience during 
which a Task might appear. A Task 
is mapped to an Experience 
through a Scope. Examples of 
experience might be: 

'ShellT ask.InMyDocumentsF older', 
'ShellTask.ImageFilesSelected', 
'ShellTask.StartPage', etc. 

Ilmplementation An entry point which can be 

launched as a result of a Task 
being clicked. 



ICategory 

IEntryPoint 

JExperience 
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IOrderedLink 



IScope 



IScopeLink 

ISiibiectTerm 

ITask 



IT askCategoryList 



Use this type to link items in a 
particular order. 

Scope defines in what Presentation 
a Task should appear during a 
certain Experience. A Task is 
mapped to an Experience through a 
Scope. Examples of Scopes might 
be: 'The Task Pane in the 
MyDocuments folder', 'The 
Context menu when an Image file 
is selected', etc. 

Used to link Scopes to an 
Experience. 

SubjectTerms are used as a user- 
browsable Index for Tasks. 

A Shell Task is a representation of 
something the system can do such 
as print a document, send a 
message or reconfigure the 
desktop. 



IT askCategorvT oplmplementati onLi st 



IT asklmplementationList 
ITaskScopelmplementationList 



ITaskScopeList 

IT askT opImplementationList 



IWindowsUser 



A windows user. 



Svstem.Storage.Svnchronization 

The following tables list examples of members exposed by the 
System.Storage.Synchronization namespace. 

Classes 

AcknowledgeChanges 
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AdapterAttribute 

AdapterConfigHandler 

AdapterFactoryT ypeAttribute 

Adapterlnstaller 

AdapterKnowledgeManager 

AdvertiseChanges 

Awareness 

CancellableObiect 

Change 

ChangeAcknowledgement 

ChangeAcknowledgement Writer 

ChangeApplier 

ChangeMetaData 

ChangeReader 

Chan geRetrie ver 

Changes 

ChangeStatus 

Change Writer 

ConfigurationTypeAttribute 

Conflict 

ConflictDictionary 

ConflictHandler 

ConflictHandlerContext 

ConflictHandlerList 

ConflictHandlerTvpesHelper 

ConflictHandlingSession 

Conflictlnformation 

ConflictLog 

ConflictManager 

ConflictRecord 

ConflictRecordCollection 

ConflictResult 

Confl ictResultln formati on 
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ConvevChanges 

DefaultChangeApplier 

DefaultChangeApplierBase 

DefaultChangeApplierConflguration 

DefaultChangeRetriever 

DefaultChangeRetrieverBase 

DefaultChangeRetrieverConfiguration 

DefaultConflictFilter 

DefaultConflictResolver 

DeleteUpdateConflict 

EmptyProflleConfigurationException 

EndpointAccessException 

EndP oi ntF ormat Attrib ute 

FolderNotFoundException 

GetltemAwarenessResult 

HashEntry 

InsertlnsertConflict 

Invalids vnchronizationProflleException 
Item A warenessIndexEl ement 
IteniAwarenessProperties 
Knowledge 

KnowledgeScopelncludeAttribute 

ListHashEnumerator 

ListHasbtable 

Local Chan ge A ckno wl edgementWriter 
LocalEndpoint 

LocalKnowledgeFormatAttribute 

LoggedConflictResiilt 

MappingNotFoundException 

NativeMethods 

OutOfSyncException 

PartnerAwareness 

Progress Value 
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Projectlnstaller 

Query 

ReiectedConflictResult 

RemoteAdapterFactory 

RemoteChangeApplierConfigurationAttribute 

RemoteChangeRetrieverConfiguration Attribute 

RemoteData 

RequestChanges 

Resol vedConflictResult 

ResponseFault 

Scope 

StateChangeEventArgs 

StoredKnowledgeChangeReader 

StoredKnowledgeChangeWriter 

SuppliedKnowledgeChangeReader 

SuppliedKnowledgeChangeWriter 

SvnchronizatlonAdapter 

SvnchronizationCancelledException 

SvnchronizationEvents 

SvnchronizationProfile 

SvnchronizationRequest 

Syn chronizati onRuntimelnstall er 

SvnchronizationSession 

SvnchronizeCompletedEventArgs 

SynchronizeProgressChangedEventArgs 

UnableToDeserializeProfileExceptlop 

UnhandledConflictException 

UpdatePeleteConflict 

UpdateUpdateConflict 

Version 

WinfsAdapterConfiguration 

WinFSChangeApplier 

WinFSChangeRetriever 
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WinfsRemoteEndpoint 

WinFSSvncDcomClass 

WinFSSyncDcomClientClass 

WinFSSvncDcomServerClass 

WinfsSvncException 

WinfsSvnchjonization Adapter 

Winfs S ynchronization AdapterF actory 

WmfsSvnchronizationAdapterlnstaller 

WinfsSynchronizationMappirig 



WinfsSyncTransportException 

WSSyncMessage 



Interfaces 

IAdapterFactory 

ICancellable 

ISvnchronizationEventsCallback 

ISynchronizationRequest 

IWinFSSvncDcomClient 

IWinFSSyncDcomListener 

IWinFSSyncDcomServer 

WinFSSvncDcoTn 

WinFSSyncDcomClient 

WinFSSyncDcomServer 



Enumerations 

AwarenessComparisonResult 
AwarenessLevelOfltem 
ChangeResult 
ConflictLogAction 
ConflictResolutionT ype 
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DefaultConflictResolverResolutionType 

ItemA warenessT ype 

QueryFormat 

ReadState 

SessionState 

SyncChangeType 

SynchronizationState 

SynchronizationT ypes 

WinfsAdapterConfigurationFlags 

WriteState 

WSSyncMessageTvpe 



Structures 

Kno wledgeScopin gld 



Delegates 

CancelHandler 

StateChangedEventHandler 

StateChan gingEventHandler 

SynchronizeCompletedEventHandler 

SynchronizeProgressChangedEventHandler 

SynchronizeStartedEventHandler 



Svstem.Storage.Svnchronization.Interop 

The following tables list examples of members exposed by the 
System.Storage.Synchronization.Interop namespace. 

Classes 

WinfsSynchronizationConfiguration 
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Interfaces 



IWinfsSynchronizationConfiguration 



System. Storage.Svnchromzation.Scheduling 

The following tables list examples of members exposed by the 

System.Storage.Synchronization.Scheduling namespace. 

Classes 

DailyTrigger 

IdleTrigger 

IntervalTrigger 

LogonTrigger 

RunOnceT rigger 

SyncScheduler 

SystemStartTrigger 

Task 

TaskList 

TemporalTrigger 

Tri g g e r 

TriggerCollection 



Enumerations 

DavsOfTheWeek 
MonthsQfThe Y ear 
W eeksOfTheM onth 
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Svstem.Storage.Svnchronization.SvncHandlcr 

The following tables list examples of members exposed by the 
System.Storage.Synchronization.SyncHandler namespace. 

Classes 

WinFSSvncHandlerBase 

Enumerations 

ProfileTvpe 



Svstem.Storage.UserT ask 

The following table lists examples of members exposed by the 

System . Storage .U serT ask namespace. 

Classes 
Appointment 

Event 



Meeting 

TaskApplicationRelationship 
TaskApplicationRelationshipCollection 
TaskCompaniesRelationship 
TaskCornpaniesRelationshipCollection 
T askDelegatorRelationship 



The Appointment type defines an 
event that happens for a limited 
period of time. 

The Event type defines an event 
that lasts over a period of time 
such as a user conference. 

The Meeting type defines a 
meeting event. 
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TaskDelegatorRelationshipCoIlection 
T ask Own erRel ati onshi p 
T askO wnerRel ati on shipCo 1 lection 
TaskRecipientsRelationship 
TaskRecipientsRelationshipCollection 
T askRequest Acceptltem 



TaskRequestDeclineltem 

TaskRequestltem 

TaskRequestUpdateltem 



UserTask 



The TaskRequest Acceptltem type 
defines behavior used when a task 
is used as a part of request for 
acceptance. 

The TaskRequestDeclineltem 
type defines behavior used when 
a task is used as a part of decline. 

The TaskRequestltem type 
defines behavior used when a task 
is used as a part of request. 

The TaskRequestUpdateltem type 
defines behavior used when a task 
is used as a part of request for 
update. 

A UserTask is something that 
someone does. 



Svstem.Storage.UserT ask.Interop 

The following table lists examples of members exposed by the 
System.Storage.UserTask.Interop namespace. 



Interfaces 



IAppointment The Appointment type defines an event that 

happens for a limited period of time. 

[Event The Event type defines an event that lasts over 

a period of time such as a user conference. 

[Meeting The Meeting type defines a meeting event. 

IT askRequestAcceptl tem The TaskRequestAcceptftem type defines 

behavior used when a task is used as a part of 
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request for acceptance. 

ITaskRequestDeclineltem The TaskRequestDeclineltem type defines 

behavior used when a task is used as a part of 
decline. 

ITaskRequestltem The TaskRequestltem type defines behavior 

used when a task is used as a part of request. 

IT askReq uestUpdateltem The TaskRequestUpdateltem type defines 

behavior used when a task is used as a part of 
request for update. 

lUserTask A UserTask is something that someone does. 

Svstem.Storage.Video 

The following tables list examples of members exposed by the 
System. Storage. Video namespace. 

Classes 

RecordedTV 

Video The type Video.Video represents a video recording. 

VideoClip 

VideoClipCollection A VideoClip collection 

VideoClipEnumerator A class for enumerating a VideoClip collection 

VideoC.lipHo.lder a class to hold VideoClip objects 

Interfaces 

IVideoClipCollection An interface representing a VideoClip collection 

IV ideoClipEnumerator interface representing a class for enumerating a 

VideoClip collection 
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Svstem.Storage.Video.Intero 



The following table lists examples of members exposed by the 
System. Storage .Video . Interop namespace. 



Interfaces 

IRecordedTV 

IVideo 

IVideoClip 



The type Video. Video represents a video recording. 



Svstem.Storage. W atcher 

The following tables list examples of members exposed by the 
System. Storage . W atcher namespace. 



Classes 

FolderltemWatcher a watcher to monitor item events under a 

folder 

F ol derltem W atcher State a Folder watcher state 

ItemChangeDetail 

ItemChangeDetailCollectlon 

ItemChan ged Event Args ItemChangedEventArgs 

ItemWatcher watcher modified/removed events on an 

object 

StoreEventArgs EventArgs returned from "WinFS" Store 

WatcherState WatcherS tate 



Enumerations 

F ol derltem W atcherOptions the options can be passed to ctors of 

FolderltemWatcher. The options can be added 
together by | 

Item Watch erOptions options on ItemWatcher 

WatcherEventT ype 
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Delegates 

ltemChangedEventHandler delegate for ItemChangedEvent in Watcher 
OnStoreEventHandler 



Svstem.Storage.Watcher.Interop 



The following table lists examples of members exposed by the 
System. Storage. Watcher.Interop namespace. 

Interfaces 

IF older! tern W atcher a watcher to monitor item events under a folder 

IF ol derl tern W atcher S tate a Folder watcher state 

HtemChangeDetail 

IltemChangedEventData ItemChangedEventArgs 



IltemWatcher 

I StoreE ventData 
IWatcherEvent 

I Watcher State 



a watcher to monitor item modified\removed 
events 

EventArgs returned from "WinFS" Store 

Implement this class in a COM app to receive 
events from an ItemWatcher or 
F olderltem W atcher 

WatcherState 



Example Computing System and Environment 

Fig. 5 illustrates an example of a suitable computing environment 400 
within which the programming framework 132 may be implemented (either fully 
or partially). The computing environment 400 may be utilized in the computer 
and network architectures described herein. 
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The exemplary computing environment 400 is only one example of a 
computing environment and is not intended to suggest any limitation as to the 
scope of use or functionality of the computer and network architectures. Neither 
should the computing environment 400 be interpreted as having any dependency 
or requirement relating to any one or combination of components illustrated in the 
exemplary computing environment 400. 

The framework 132 may be implemented with numerous other general 
purpose or special purpose computing system environments or configurations. 
Examples of well known computing systems, environments, and/or configurations 
that may be suitable for use include, but are not limited to, personal computers, 
server computers, multiprocessor systems, microprocessor-based systems, network 
PCs, minicomputers, mainframe computers, distributed computing environments 
that include any of the above systems or devices, and so on. Compact or subset 
versions of the framework may also be implemented in clients of limited 
resources, such as cellular phones, personal digital assistants, handheld computers, 
or other communication/computing devices. 

The framework 132 may be described in the general context of computer- 
executable instructions, such as program modules, being executed by one or more 
computers or other devices. Generally, program modules include routines, 
programs, objects, components, data structures, etc. that perform particular tasks 
or implement particular abstract data types. The framework 132 may also be 
practiced in distributed computing environments where tasks are performed by 
remote processing devices that are linked through a communications network. In 
a distributed computing environment, program modules may be located in both 
local and remote computer storage media including memory storage devices. 
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The computing environment 400 includes a general-purpose computing 
device in the form of a computer 402. The components of computer 402 can 
include, by are not limited to, one or more processors or processing units 404, a 
system memory 406, and a system bus 408 that couples various system 
components including the processor 404 to the system memory 406. 

The system bus 408 represents one or more of several possible types of bus 
structures, including a memory bus or memory controller, a peripheral bus, an 
accelerated graphics port, and a processor or local bus using any of a variety of 
bus architectures. By way of example, such architectures can include an Industry 
Standard Architecture (ISA) bus, a Micro Channel Architecture (MCA) bus, an 
Enhanced ISA (EISA) bus, a Video Electronics Standards Association (VESA) 
local bus, and a Peripheral Component Interconnects (PCI) bus also known as a 
Mezzanine bus. 

Computer 402 typically includes a variety of computer readable media. 
Such media can be any available media that is accessible by computer 402 and 
includes both volatile and non-volatile media, removable and non-removable 
media. 

The system memory 406 includes computer readable media in the form of 
volatile memory, such as random access memory (RAM) 410, and/or non-volatile 
memory, such as read only memory (ROM) 412. A basic input/output system 
(BIOS) 414, containing the basic routines that help to transfer information 
between elements within computer 402, such as during start-up, is stored in ROM 
412. RAM 410 typically contains data and/or program modules that are 
immediately accessible to and/or presently operated on by the processing unit 404. 
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Computer 402 may also include other removable/non-removable, 
volatile/non-volatile computer storage media. By way of example, Fig. 5 
illustrates a hard disk drive 416 for reading from and writing to a non-removable, 
non-volatile magnetic media (not shown), a magnetic disk drive 418 for reading 
from and writing to a removable, non-volatile magnetic disk 420 (e.g., a “floppy 
disk”), and an optical disk drive 422 for reading from and/or writing to a 
removable, non-volatile optical disk 424 such as a CD-ROM, DVD-ROM, or other 
optical media. The hard disk drive 416, magnetic disk drive 418, and optical disk 
drive 422 are each connected to the system bus 408 by one or more data media 
interfaces 426. Alternatively, the hard disk drive 416, magnetic disk drive 418, 
and optical disk drive 422 can be connected to the system bus 408 by one or more 
interfaces (not shown). 

The disk drives and their associated computer-readable media provide non- 
volatile storage of computer readable instructions, data structures, program 
modules, and other data for computer 402. Although the example illustrates a hard 
disk 416, a removable magnetic disk 420, and a removable optical disk 424, it is to 
be appreciated that other types of computer readable media which can store data 
that is accessible by a computer, such as magnetic cassettes or other magnetic 
storage devices, flash memory cards, CD-ROM, digital versatile disks (DVD) or 
other optical storage, random access memories (RAM), read only memories 
(ROM), electrically erasable programmable read-only memory (EEPROM), and 
the like, can also be utilized to implement the exemplary computing system and 
environment. 

Any number of program modules can be stored on the hard disk 416, 
magnetic disk 420, optical disk 424, ROM 412, and/or RAM 410, including by 
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way of example, an operating system 426, one or more application programs 428, 
other program modules 430, and program data 432. Each of the operating system 
426, one or more application programs 428, other program modules 430, and 
program data 432 (or some combination thereof) may include elements of the 
programming framework 132. 

A user can enter commands and information into computer 402 via input 
devices such as a keyboard 434 and a pointing device 436 (e.g., a “mouse”). 
Other input devices 438 (not shown specifically) may include a microphone, 
joystick, game pad, satellite dish, serial port, scanner, and/or the like. These and 
other input devices are connected to the processing unit 404 via input/output 
interfaces 440 that are coupled to the system bus 408, but may be connected by 
other interface and bus structures, such as a parallel port, game port, or a universal 
serial bus (USB). 

A monitor 442 or other type of display device can also be connected to the 
system bus 408 via an interface, such as a video adapter 444. In addition to the 
monitor 442, other output peripheral devices can include components such as 
speakers (not shown) and a printer 446 which can be connected to computer 402 
via the input/output interfaces 440. 

Computer 402 can operate in a networked environment using logical 
connections to one or more remote computers, such as a remote computing device 
448. By way of example, the remote computing device 448 can be a personal 
computer, portable computer, a server, a router, a network computer, a peer device 
or other common network node, and so on. The remote computing device 448 is 
illustrated as a portable computer that can include many or all of the elements and 
features described herein relative to computer 402. 
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Logical connections between computer 402 and the remote computer 448 
are depicted as a local area network (LAN) 450 and a general wide area network 
(WAN) 452. Such networking environments are commonplace in offices, 
enterprise- wide computer networks, intranets, and the Internet. 

When implemented in a LAN networking environment, the computer 402 is 
connected to a local network 450 via a network interface or adapter 454. When 
implemented in a WAN networking environment, the computer 402 typically 
includes a modem 456 or other means for establishing communications over the 
wide network 452. The modem 456, which can be internal or external to computer 
402, can be connected to the system bus 408 via the input/output interfaces 440 or 
other appropriate mechanisms. It is to be appreciated that the illustrated network 
connections are exemplary and that other means of establishing communication 
link(s) between the computers 402 and 448 can be employed. 

In a networked environment, such as that illustrated with computing 
environment 400, program modules depicted relative to the computer 402, or 
portions thereof, may be stored in a remote memory storage device. By way of 
example, remote application programs 458 reside on a memory device of remote 
computer 448. For purposes of illustration, application programs and other 
executable program components such as the operating system are illustrated herein 
as discrete blocks, although it is recognized that such programs and components 
reside at various times in different storage components of the computing device 
402, and are executed by the data processor(s) of the computer. 

An implementation of the framework 132 and/or 150, and particularly, the 
API included in the framework 132 and/or 150 or calls made to the API included 
in the framework 132 and/or 150, may be stored on or transmitted across some 
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form of computer readable media. Computer readable media can be any available 
media that can be accessed by a computer. By way of example, and not limitation, 
computer readable media may comprise “computer storage media” and 
“communications media.” “Computer storage media” include volatile and non- 
volatile, removable and non-removable media implemented in any method or 
technology for storage of information such as computer readable instructions, data 
structures, program modules, or other data. Computer storage media includes, but 
is not limited to, RAM, ROM, EEPROM, flash memory or other memory 
technology, CD-ROM, digital versatile disks (DVD) or other optical storage, 
magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage 
devices, or any other medium which can be used to store the desired information 
and which can be accessed by a computer. 

“Communication media” typically embodies computer readable 
instructions, data structures, program modules, or other data in a modulated data 
signal, such as carrier wave or other transport mechanism. Communication media 
also includes any information delivery media. The term “modulated data signal” 
means a signal that has one or more of its characteristics set or changed in such a 
manner as to encode information in the signal. By way of example, and not 
limitation, communication media includes wired media such as a wired network or 
direct-wired connection, and wireless media such as acoustic, RF, infrared, and 
other wireless media. Combinations of any of the above are also included within 
the scope of computer readable media. 

Alternatively, portions of the framework may be implemented in hardware 
or a combination of hardware, software, and/or firmware. For example, one or 
more application specific integrated circuits (ASICs) or programmable logic 
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1 devices (PLDs) could be designed or programmed to implement one or more 

2 portions of the framework. 

3 A programming interface (or more simply, interface) may be viewed as any 

4 mechanism, process, protocol for enabling one or more segment(s) of code to 

5 communicate with or access the functionality provided by one or more other 

6 segments) of code. Alternatively, a programming interface may be viewed as one 

7 or more mechanism(s), method(s), function call(s), module(s), object(s), etc. of a 

8 component of a system capable of communicative coupling to one or more 

9 mechanism(s), method(s), function call(s), module(s), etc. of other component(s). 

10 The term “segment of code” in the preceding sentence is intended to include one 

11 or more instructions or lines of code, and includes, e.g., code modules, objects, 

12 subroutines, functions, and so on, regardless of the terminology applied or whether 

13 the code segments are separately compiled, or whether the code segments are 
H provided as source, intermediate, or object code, whether the code segments are 
is utilized in a runtime system or process, or whether they are located on the same or 

1 6 different machines or distributed across multiple machines, or whether the 

17 functionality represented by the segments of code are implemented wholly in 
is software, wholly in hardware, or a combination of hardware and software. 

19 Notionally, a programming interface may be viewed generically, as shown 

20 in Fig. 6 or Fig. 7 . Fig. 6 illustrates an interface Interface 1 as a conduit through 

21 which first and second code segments communicate. Fig. 7 illustrates an interface 

22 as comprising interface objects II and 12 (which may or may not be part of the 

23 first and second code segments), which enable first and second code segments of a 

24 system to communicate via medium M. In the view of Fig. 7 , one may consider 

25 interface objects II and 12 as separate interfaces of the same system and one may 
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also consider that objects II and 12 plus medium M comprise the interface. 
Although Figs. 6 and 7 show bi-directional flow and interfaces on each side of the 
flow, certain implementations may only have information flow in one direction (or 
no information flow as described below) or may only have an interface object on 
one side. By way of example, and not limitation, terms such as application 
programming or program interface (API), entry point, method, function, 
subroutine, remote procedure call, and component object model (COM) interface, 
are encompassed within the definition of programming interface. 

Aspects of such a programming interface may include the method whereby 
the first code segment transmits information (where “information” is used in its 
broadest sense and includes data, commands, requests, etc.) to the second code 
segment; the method whereby the second code segment receives the information; 
and the structure, sequence, syntax, organization, schema, timing and content of 
the information. In this regard, the underlying transport medium itself may be 
unimportant to the operation of the interface, whether the medium be wired or 
wireless, or a combination of both, as long as the information is transported in the 
manner defined by the interface. In certain situations, information may not be 
passed in one or both directions in the conventional sense, as the information 
transfer may be either via another mechanism (e.g. information placed in a buffer, 
file, etc. separate from information flow between the code segments) or non- 
existent, as when one code segment simply accesses functionality performed by a 
second code segment. Any or all of these aspects may be important in a given 
situation, e.g., depending on whether the code segments are part of a system in a 
loosely coupled or tightly coupled configuration, and so this list should be 
considered illustrative and non-limiting. 
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This notion of a programming interface is known to those skilled in the art 
and is clear from the foregoing detailed description of the invention. There are, 
however, other ways to implement a programming interface, and, unless expressly 
excluded, these too are intended to be encompassed by the claims set forth at the 
end of this specification. Such other ways may appear to be more sophisticated or 
complex than the simplistic view of Figs. 6 and 7, but they nonetheless perform a 
similar function to accomplish the same overall result. We will now briefly 
describe some illustrative alternative implementations of a programming interface. 

A. FACTORING 

A communication from one code segment to another may be accomplished 
indirectly by breaking the communication into multiple discrete communications. 
This is depicted schematically in Figs. 8 and 9. As shown, some interfaces can be 
described in terms of divisible sets of functionality. Thus, the interface 
functionality of Figs. 6 and 7 may be factored to achieve the same result, just as 
one may mathematically provide 24, or 2 times 2 times 3 times 2. Accordingly, as 
illustrated in Fig. 8, the function provided by interface Interface 1 may be 
subdivided to convert the communications of the interface into multiple interfaces 
Interface 1 A, Interface IB, Interface 1C, etc. while achieving the same result. As 
illustrated in Fig. 9, the function provided by interface II may be subdivided into 
multiple interfaces I la, I lb, lie, etc. while achieving the same result. Similarly, 
interface 12 of the second code segment which receives information from the first 
code segment may be factored into multiple interfaces I2a, I2b, I2c, etc. When 
factoring, the number of interfaces included with the 1 st code segment need not 
match the number of interfaces included with the 2 nd code segment. In either of the 
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1 cases of Figs. 8 and 9, the functional spirit of interfaces Interface 1 and II remain 

2 the same as with Figs. 6 and 7, respectively. The factoring of interfaces may also 

3 follow associative, commutative, and other mathematical properties such that the 

4 factoring may be difficult to recognize. For instance, ordering of operations may 

5 be unimportant, and consequently, a function carried out by an interface may be 

6 carried out well in advance of reaching the interface, by another piece of code or 

7 interface, or performed by a separate component of the system. Moreover, one of 

8 ordinary skill in the programming arts can appreciate that there are a variety of 

9 ways of making different function calls that achieve the same result. 

10 

11 B. REDEFINITION 

12 In some cases, it may be possible to ignore, add or redefine certain aspects 

1 3 (e.g., parameters) of a programming interface while still accomplishing the 

1 4 intended result. This is illustrated in Figs. 10 and 11. For example, assume 
is interface Interfacel of Fig. 6 includes a function call Square(input, precision, 

16 output), a call that includes three parameters, input, precision and output, and 

17 which is issued from the 1 st Code Segment to the 2 nd Code Segment., If the middle 

18 parameter precision is of no concern in a given scenario, as shown in Fig. 10, it 

19 could just as well be ignored or even replaced with a meaningless (in this 

20 situation) parameter. One may also add an additional parameter of no concern. In 

21 either event, the functionality of square can be achieved, so long as output is 

22 returned after input is squared by the second code segment. Precision may very 

23 well be a meaningful parameter to some downstream or other portion of the 

24 computing system; however, once it is recognized that precision is not necessary 

25 for the narrow purpose of calculating the square, it may be replaced or ignored. 
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For example, instead of passing a valid precision value, a meaningless value such 
as a birth date could be passed without adversely affecting the result. Similarly, as 
shown in Fig. 11, interface II is replaced by interface IT, redefined to ignore or 
add parameters to the interface. Interface 12 may similarly be redefined as 
interface 12’, redefined to ignore unnecessary parameters, or parameters that may 
be processed elsewhere. The point here is that in some cases a programming 
interface may include aspects, such as parameters, that are not needed for some 
purpose, and so they may be ignored or redefined, or processed elsewhere for 
other purposes. 

C. INLINE CODING 

It may also be feasible to merge some or all of the functionality of two 
separate code modules such that the “interface” between them changes form. For 
example, the functionality of Figs. 6 and 7 may be converted to the functionality 
of Figs. 12 and 13, respectively. In Fig. 12, the previous 1 st and 2 nd Code Segments 
of Fig. 6 are merged into a module containing both of them. In this case, the code 
segments may still be communicating with each other but the interface may be 
adapted to a form which is more suitable to the single module. Thus, for example, 
formal Call and Return statements may no longer be necessary, but similar 
processing or response(s) pursuant to interface Interface 1 may still be in effect. 
Similarly, shown in Fig. 13, part (or all) of interface 12 from Fig. 7 may be written 
inline into interface II to form interface II”. As illustrated, interface 12 is divided 
into I2a and I2b, and interface portion I2a has been coded in-line with interface II 
to form interface II”. For a concrete example, consider that the interface II from 
Fig. 7 performs a function call square ( input , output ), which is received by 
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interface 12, which after processing the value passed with input (to square it) by 
the second code segment, passes back the squared result with output. In such a 
case, the processing performed by the second code segment (squaring input) can 
be performed by the first code segment without a call to the interface. 

D. DIVORCE 

A communication from one code segment to another may be accomplished 
indirectly by breaking the communication into multiple discrete communications. 
This is depicted schematically in Figs. 14 and 15. As shown in Fig. 14, one or 
more piece(s) of middleware (Divorce Interface(s), since they divorce 
functionality and / or interface functions from the original interface) are provided 
to convert the communications on the first interface, Interface 1, to conform them 
to a different interface, in this case interfaces Interface2A, Interface2B and 
Interface2C. This might be done, e.g., where there is an installed base of 
applications designed to communicate with, say, an operating system in 
accordance with an Interface 1 protocol, but then the operating system is changed 
to use a different interface, in this case interfaces Interface2A, Interface2B and 
Interface2C. The point is that the original interface used by the 2 nd Code Segment 
is changed such that it is no longer compatible with the interface used by the 1 st 
Code Segment, and so an intermediary is used to make the old and new interfaces 
compatible. Similarly, as shown in Fig. 15, a third code segment can be introduced 
with divorce interface Dll to receive the communications from interface II and 
with divorce interface DI2 to transmit the interface functionality to, for example, 
interfaces I2a and I2b, redesigned to work with DI2, but to provide the same 
functional result. Similarly, Dll and DI2 may work together to translate the 
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functionality of interfaces II and 12 of Fig. 7 to a new operating system, while 
providing the same or similar functional result. 

E. REWRITING 

Yet another possible variant is to dynamically rewrite the code to replace 
the interface functionality with something else but which achieves the same 
overall result. For example, there may be a system in which a code segment 
presented in an intermediate language (e.g. Microsoft IL, Java ByteCode, etc.) is 
provided to a Just-in-Time (JIT) compiler or interpreter in an execution 
environment (such as that provided by the .Net framework, the Java runtime 
environment, or other similar runtime type environments). The JIT compiler may 
be written so as to dynamically convert the communications from the 1 st Code 
Segment to the 2 nd Code Segment, i.e., to conform them to a different interface as 
may be required by the 2 nd Code Segment (either the original or a different 2 nd 
Code Segment). This is depicted in Figs. 16 and 17. As can be seen in Fig. 16, this 
approach is similar to the Divorce scenario described above. It might be done, e.g., 
where an installed base of applications are designed to communicate with an 
operating system in accordance with an Interface 1 protocol, but then the operating 
system is changed to use a different interface. The JIT Compiler could be used to 
conform the communications on the fly from the install ed-base applications to the 
new interface of the operating system. As depicted in Fig. 17, this approach of 
dynamically rewriting the interface(s) may be applied to dynamically factor, or 
otherwise alter the interface(s) as well. 

It is also noted that the above-described scenarios for achieving the same or 
similar result as an interface via alternative embodiments may also be combined in 
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various ways, serially and/or in parallel, or with other intervening code. Thus, the 
alternative embodiments presented above are not mutually exclusive and may be 
mixed, matched and combined to produce the same or equivalent scenarios to the 
generic scenarios presented in Figs. 6 and 7. It is also noted that, as with most 
programming constructs, there are other similar ways of achieving the same or 
similar functionality of an interface which may not be described herein, but 
nonetheless are represented by the spirit and scope of the invention, i.e., it is noted 
that it is at least partly the functionality represented by, and the advantageous 
results enabled by, an interface that underlie the value of an interface. 

Conclusion 

Although the invention has been described in language specific to structural 
features and/or methodological acts, it is to be understood that the invention 
defined in the appended claims is not necessarily limited to the specific features or 
acts described. Rather, the specific features and acts are disclosed as exemplary 
forms of implementing the claimed invention. 
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